doc: clarify that returned EvaluationSeriesData must not be retained

kinyoklion · kinyoklion · commit da215a4827fe · 2026-04-13T15:43:20.000-07:00
diff --git a/libs/server-sdk/include/launchdarkly/server_side/bindings/c/hook.h b/libs/server-sdk/include/launchdarkly/server_side/bindings/c/hook.h
@@ -51,7 +51,8 @@ typedef struct p_LDServerSDKTrackSeriesContext* LDServerSDKTrackSeriesContext;
  *
  * RETURNS:
  * EvaluationSeriesData to pass to afterEvaluation. Return the input data
- * unmodified if you don't need to add anything. Ownership transfers to SDK.
+ * unmodified if you don't need to add anything. Ownership transfers to SDK;
+ * the caller must not retain or access the returned pointer after returning.
  * If NULL is returned, an empty data object will be created.
  *
  * LIFETIME:
@@ -81,7 +82,8 @@ typedef LDServerSDKEvaluationSeriesData (*LDServerSDKHook_BeforeEvaluation)(
  *
  * RETURNS:
  * EvaluationSeriesData for potential future stages. Return the input data
- * unmodified if you don't need to modify it. Ownership transfers to SDK.
+ * unmodified if you don't need to modify it. Ownership transfers to SDK;
+ * the caller must not retain or access the returned pointer after returning.
  * If NULL is returned, an empty data object will be created.
  *
  * LIFETIME:

Original file line number	Diff line number	Diff line change
`@@ -51,7 +51,8 @@ typedef struct p_LDServerSDKTrackSeriesContext* LDServerSDKTrackSeriesContext;`
`51`	`51`	`*`
`52`	`52`	`* RETURNS:`
`53`	`53`	`* EvaluationSeriesData to pass to afterEvaluation. Return the input data`
`54`		`- * unmodified if you don't need to add anything. Ownership transfers to SDK.`
	`54`	`+ * unmodified if you don't need to add anything. Ownership transfers to SDK;`
	`55`	`+ * the caller must not retain or access the returned pointer after returning.`
`55`	`56`	`* If NULL is returned, an empty data object will be created.`
`56`	`57`	`*`
`57`	`58`	`* LIFETIME:`
`@@ -81,7 +82,8 @@ typedef LDServerSDKEvaluationSeriesData (*LDServerSDKHook_BeforeEvaluation)(`
`81`	`82`	`*`
`82`	`83`	`* RETURNS:`
`83`	`84`	`* EvaluationSeriesData for potential future stages. Return the input data`
`84`		`- * unmodified if you don't need to modify it. Ownership transfers to SDK.`
	`85`	`+ * unmodified if you don't need to modify it. Ownership transfers to SDK;`
	`86`	`+ * the caller must not retain or access the returned pointer after returning.`
`85`	`87`	`* If NULL is returned, an empty data object will be created.`
`86`	`88`	`*`
`87`	`89`	`* LIFETIME:`