ldap_add_ext_s

Syntax

  #include <ldap.h>
  
  int ldap_add_ext_s (
     LDAP           *ld,
     const char     *dn,
     LDAPMod       **attrs,
     LDAPControl   **serverctrls,
     LDAPControl   **clientctrls);
  
  

Parameters

ld

(IN) Points to the handle for the LDAP session.

dn

(IN) Points to the distinguished name of the entry to add, for example: "o=novell", "ou=provo", "cn=kim"

All components of the dn must exist except for the leaf component. The leaf component name must be unique within the container.

attrs

(IN) Points to a NULL-terminated array of LDAPMod structures that contain the attributes and values to add with the entry. All mandatory attributes must have values or the operation fails.

serverctrls

(IN) Points to an array of LDAPControl structures that list the server controls to use with the add. Use NULL to specify no server controls.

clientctrls

(IN) Points to an array of LDAPControl structures that list the client controls to use with the add. Use NULL to specify no client controls.

msgidp

(OUT) Points to the message ID of the request when the add request succeeds.

Return Values

Remarks

For a list of mandatory attributes for an entry see the LDAP server's schema. For eDirectory, see NDK: Novell eDirectory Schema Reference.

If you are adding an entry that logs in to the directory, you need to set a value for the userPassword attribute. The userPassword attribute is not a mandatory attriubute. However, if you create an entry without a userPassword attribute, the entry cannot log in.

eDirectory does not currently support any server-side controls to use with adding entries.

For sample code, see addentry.c and addentry1.c.

See Also

ldap_add, ldap_add_s, ldap_add_ext,