#include <ldap.h>
int ldap_modify_ext( LDAP *ld, const char *dn, LDAPMod **mods,
LDAPControl **serverctrls, LDAPControl **clientctrls,
int *msgidp );
ld |
Connection handle, which is a pointer to an |
dn | |
mods |
Pointer to a NULL-terminated array of pointers to |
serverctrls |
Pointer to an array of |
clientctrls |
Pointer to an array of |
msgidp |
Pointer to an integer that will be set to the message ID of the LDAP operation. To check the result of this operation, call |
LDAP_SUCCESS if successful. LDAP_PARAM_ERROR if any of the arguments are invalid. LDAP_ENCODING_ERROR if an error occurred when BER-encoding the request. LDAP_SERVER_DOWN if the LDAP server did not receive the request or if the connection to the server was lost. LDAP_NO_MEMORY if memory cannot be allocated. LDAP_NOT_SUPPORTED if controls are included in your request (for example, as a session preference) and your LDAP client does not specify that it is using the LDAP v3 protocol. Make sure that you set the version of your LDAP client to version 3 before calling this function. (For details, see "Specifying the LDAP Version of Your Client" on page 54.) ldap_modify_ext() modifies an entry in the directory asynchronously.
This function is a new version of the ldap_modify() function. If you are writing a new LDAP client, you should call this function instead of ldap_modify().
To make changes to an entry to the directory, you need to specify the following information:
dn argument to specify the DN of the entry that you want to modify. LDAPMod structure for change that you want to make to an attribute. Create an array of these LDAPMod structures and pass the array as the mods argument.
For information on using the LDAPMod structure to specify a change, see LDAPMod. ldap_modify_ext() is an asynchronous function; it does not directly return results. If you want the results to be returned directly by the function, call the synchronous function ldap_modify_ext_s() instead. (For more information on asynchronous and synchronous functions, see "Calling Synchronous and Asynchronous Functions" on page 80.)
In order to get the results of the LDAP modify operation, you need to call the ldap_result() function and the ldap_parse_result() function. (See "Calling Asynchronous Functions" on page 82 for details.) For a list of possible result codes for an LDAP modify operation, see the result code documentation for the ldap_modify_ext_s() function.
For more information on modifying entries in the directory, see "Modifying an Entry" on page 188.
ldap_modify_ext_s(), ldap_result(), ldap_parse_result(), LDAPMod.
Last Updated: 10/01/98 17:06:23