ldapModifyW(3ibx) — Subroutines
NAME
ldapModifyW − Modifies an entry in a directory tree.
SYNOPSIS
| #include <libldap.h> | ||
| int ldapModifyW( | LDAP_t ∗ldap_handle, | |
| char ∗distinguished_name, | ||
| LDAPMod ∗modifications_list ); |
INPUT PARAMETERS
ldap_handleThe address of an LDAP handle.
distinguished_nameThe address of a string containing the distinguished name of the entry in the directory tree that you want to modify. The following is an example of an LDAP-compliant distinguished name:
(cn="Joan Smith", ou=marketing, o="Big Corporation", c=us)
modifications_listPointer to the first structure in a NULL-terminated linked list of structures, each of which provides information about the type of modification, the attribute name whose value or values are to change, and a pointer to a NULL-terminated list of pointers that point to the new attribute values.
In the first member of a structure, you can specify constants that designate the type of modification to be made. If you are specifying binary data, you can perform a logical OR operation (|) on the binary-data constant (LDAP_MOD_BVALUES) and on one other constant. Here are the valid constants for the first member of the structure:
| LDAP_MOD_ADD | Add an attribute value to the | |
| entry. | ||
| LDAP_MOD_DELETE | Delete an attribute value from | |
| the entry. | ||
| LDAP_MOD_REPLACE | Replace an existing attribute | |
| value in the entry with another | ||
| attribute value. | ||
| LDAP_MOD_BVALUES | The attribute value in the entry | |
| is binary data. |
DESCRIPTION
The ldapModifyW function performs its task synchronously.
INFOBROKER NOTES
This function works only with an X.500 Directory Service; you cannot use this function to modify entries to the InfoBroker workgroup directory.
RETURNS
One of the LDAP standard return values: LDAP_message.
RELATED INFORMATION
Functions: ldapAddW(3), ldapDeleteDNW(3).