## Directory Modify Operations

Modify functions alter information in the directory. For example, if an employee of an organizational unit transfers to a new organizational unit, a typical modify request would modify the OU name attribute in the person's directory entry to reflect the change.

XDS API implements the following modify functions:

· ds_modify_entry( )

The requestor gives a distinguished name and a list of modifications to the named entry. The directory service carries out the specified changes if the user requesting the change has proper access rights.

· ds_add_entry( )

The requestor gives a distinguished name and values for a new entry. The entry is added as a leaf node in the DIT if the user requesting the change has proper access rights.

· ds_remove_entry( )

The requestor gives a distinguished name. The entry with that name is removed if the user requesting the change has proper access rights.

· ds_modify_rdn( )

The requestor gives a distinguished name and a new RDN for the entry. The directory changes the entry's RDN if the user requesting the change has proper access rights.

Note that ds_add_entry( ), ds_remove_entry( ), and ds_modify_rdn( ) only apply to leaf entries. They are not intended to provide a general facility for building and manipulating the DIT.

More:

Modifying Directory Entries

Step 1: Export Object Identifiers for Required Directory Classes and Attributes

Step 2: Declare Local Variables

Step 3: Build Public Objects

Step 4: Create Descriptor Lists for Attributes

Step 5: Perform the Operations

###