summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStefan Metzmacher <metze@samba.org>2007-01-07 19:04:40 +0000
committerGerald (Jerry) Carter <jerry@samba.org>2007-10-10 14:37:12 -0500
commit22f473b22bc2b2aae2b53a180b78c2e891ab956e (patch)
treef26b75063692c7a9ae0ec8b1565a66c6363dd47c
parentb931e6683508ddbd77a34725913f706870ed8eb7 (diff)
downloadsamba-22f473b22bc2b2aae2b53a180b78c2e891ab956e.tar.gz
samba-22f473b22bc2b2aae2b53a180b78c2e891ab956e.tar.bz2
samba-22f473b22bc2b2aae2b53a180b78c2e891ab956e.zip
r20598: add comments and make clear that the void *data element for extended operations
needs to be NULL or a valid talloc pointer as talloc_get_type() will be called on it. metze (This used to be commit 5731617ea9103eaaef2c5591aab89d59ded35fd8)
-rw-r--r--source4/lib/ldb/include/ldb.h12
1 files changed, 7 insertions, 5 deletions
diff --git a/source4/lib/ldb/include/ldb.h b/source4/lib/ldb/include/ldb.h
index 7b37b50468..62afbfb609 100644
--- a/source4/lib/ldb/include/ldb.h
+++ b/source4/lib/ldb/include/ldb.h
@@ -676,7 +676,7 @@ enum ldb_state {
struct ldb_extended {
const char *oid;
- void *data;
+ void *data; /* NULL or a valid talloc pointer! talloc_get_type() will be used on it */
};
struct ldb_result {
@@ -1118,7 +1118,8 @@ int ldb_extended_default_callback(struct ldb_context *ldb, void *context, struct
\param ldb the context associated with the database (from ldb_init())
\param mem_ctx a talloc emmory context (used as parent of ret_req)
\param oid the OID of the extended operation.
- \param data void pointer a the extended operation specific parameters
+ \param data a void pointer a the extended operation specific parameters,
+ it needs to be NULL or a valid talloc pointer! talloc_get_type() will be used on it
\param controls an array of controls
\param context the callback function context
\param the callback function to handle the async replies
@@ -1129,7 +1130,7 @@ int ldb_build_extended_req(struct ldb_request **ret_req,
struct ldb_context *ldb,
void *mem_ctx,
const char *oid,
- void *data,
+ void *data,/* NULL or a valid talloc pointer! talloc_get_type() will be used on it */
struct ldb_control **controls,
void *context,
ldb_request_callback_t callback);
@@ -1141,7 +1142,8 @@ int ldb_build_extended_req(struct ldb_request **ret_req,
\param ldb the context associated with the database (from ldb_init())
\param oid the OID of the extended operation.
- \param data void pointer a the extended operation specific parameters
+ \param data a void pointer a the extended operation specific parameters,
+ it needs to be NULL or a valid talloc pointer! talloc_get_type() will be used on it
\param res the result of the extended operation
\return result code (LDB_SUCCESS if the extended operation returned fine,
@@ -1149,7 +1151,7 @@ int ldb_build_extended_req(struct ldb_request **ret_req,
*/
int ldb_extended(struct ldb_context *ldb,
const char *oid,
- void *data,
+ void *data,/* NULL or a valid talloc pointer! talloc_get_type() will be used on it */
struct ldb_result **res);
/**