Share this page

# mldap_modify

Listing Directory Functions (mldap)

Modifies an entry's attribute value.

    int mldap_modify( char *transaction, char *dn, <List of Attributes>, LAST );

transaction | A transaction name for this step. To instruct VuGen not to create a transaction for this step, use a NULL string, "".
dn | A Distinguished Name entry. Use the following format: `"DN=`RDN1`,` RDN2`,"...`
List of Attributes | DN 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_modify function changes the value of an LDAP entry attribute. You can only modify one entry per function. To modify the attributes of another entry, use an additional mldap_modify function.

This function is for use with global sessions. For multiple sessions, use the mldap_modify_ex function, which allows you to specify a 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_modify function changes the name attribute to Jane.

Copy code

    mldap_modify("LDAP Modify",
             "DN=cn=Sally R. Jones,OU=Sales,DC=TECHNO,DC=com",
             "AttrName=name",    // Name of attribute
             "AttrValue=Jane",    // New Value
             LAST );

Tips to improve your search results... VuGen Function Reference Version 26.1-26.3 Function Reference 26.1-26.3 All View Local Help Center View Online Help Center Version: