mldap_add_ex

Listing Directory Functions (mldap)

Adds an entry to the LDAP directory for a specific session.

int mldap_add_ex( MLDAP *pldap, char *transaction, char *dn, <List of Attributes>, LAST );
pldap An LDAP session identifier
transactionA transaction name for this step. To instruct VuGen not to create a transaction for this step, use a NULL string, "".
dnA Distinguished Name entry. Use the following format: "DN=RDN1, RDN2,"...
List of AttributesDN entry attributes and values. To mark the end of an attribute, use the ENDITEM string.
LAST A marker indicating the end of the argument list.

The mldap_add_ex function adds an entry to the LDAP directory for a specific session.

This function is for use with multiple sessions. For global sessions, use the mldap_add function, which leaves out the session identifier.

Return Values

If this function succeeds, it returns E_OK. Otherwise, it returns a negative value.

Parameterization

The following argument(s) can be parameterized with standard parameterization: dn

Example

In the following example, the mldap_add_ex function adds an entry for Sally R. Jones, assigning a single value to each attribute.

mldap_add_ex(pldap,"LDAP Add",
         "DN=cn=Sally R. Jones,OU=Sales,OU=demo,DC=TECHNO,DC=com",
         "Name=givenName", "Value=Sally", ENDITEM,
         "Name=initials", "Value=R", ENDITEM,
         "Name=sn", "Value=Jones", ENDITEM,
         "Name=objectClass", "Value=contact", ENDITEM,
         LAST );

In the following example, mldap_add_ex adds an entry for Sally R. Jones, assigning multiple values to an attribute.

mldap_add_ex(pldap,"LDAP Add",
         "DN=cn=Sally R. Jones,OU=Sales,OU=demo,DC=TECHNO,DC=com",
         "Name=initials", "Value=S", "Value=R", "Value=J", ENDITEM,
         "Name=objectClass", "Value=contact", ENDITEM,
         LAST );