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:
Step 1: Export Object Identifiers for Required Directory Classes and Attributes
Step 2: Declare Local Variables
Step 4: Create Descriptor Lists for Attributes
Step 5: Perform the Operations