ldapAddW(3ibx) — Subroutines
NAME
ldapAddW − Adds a entry to a directory tree.
SYNOPSIS
| #include <libldap.h> | ||
| int ldapAddW( | LDAP_t ∗ldap_handle, | |
| char ∗distinguished_name, | ||
| LDAPMod ∗modifications_list ); |
INPUT PARAMETERS
ldap_handleThe address of an LDAP handle.
distinguished_nameThe distinguished name of the entry that you want to add to the directory tree. The following is an example of an LDAP-compliant distinguished name:
(cn="Joan Smith", ou=marketing, o="Big Corporation", c=us)
modifications_listAddress of the first structure in a NULL-terminated linked list of structures. The structure’s first member is often NULL. Since the purpose of this function is to add an entry and its new attributes, it automatically assumes the value LDAP_MOD_ADD as the value of the first member. If the value of the new entry’s attribute is binary, then specify LDAP_MOD_BVALUES instead of NULL.
The structure’s second member provides the name of the new entry’s attribute, and its last member provides a pointer to a NULL-terminated list of pointers; the pointers in the list point to the new entry’s attribute values.
DESCRIPTION
The ldapAddW function performs its task synchronously.
INFOBROKER NOTES
This function works only with an X.500 Directory Service; you cannot use this function to add entries to the InfoBroker workgroup directory.
RETURNS
One of the LDAP standard return values: LDAP_message.
RELATED INFORMATION
Functions: ldapDeleteDNW(3), ldapErrorToText(3), ldapModifyW(3).