The DS_C_ENTRY_MOD class object holds the information associated with a directory entry modification. (For an illustration of its structure, see the figure, The DS_C_ENTRY_MOD_LIST Object.) Each DS_C_ENTRY_MOD object describes one modification. To create a list of modifications suitable to be passed to a ds_modify_entry( ) call, describe each modification in a separate DS_C_ENTRY_MOD object, and then insert these objects as multiple instances of the DS_CHANGES attribute in a DS_C_ENTRY_MOD_LIST object (see The DS_C_ENTRY_MOD_LIST Object).
· OM_CLASS
The value of this attribute is an OID string that identifies the object's class; its value is always DS_C_ENTRY_MOD.
· DS_ATTRIBUTE_TYPE
The value of this attribute, which is an OID string, identifies the directory attribute whose modification is described in this object.
· DS_ATTRIBUTE_VALUES
These are the values required for the entry modification; their type and number depend on both the entry type and the modification requested.
· DS_MOD_TYPE
The value of this attribute identifies the kind of modification requested. It can be one of the following:
- DS_ADD_ATTRIBUTE
The attribute specified by DS_ATTRIBUTE_TYPE is not currently in the entry. It should be added, along with the value(s) specified by DS_ATTRIBUTE_VALUES, to the entry. The entry itself is specified in a separate DS_C_DS_DN object, which is also passed to ds_modify_entry( ).
- DS_ADD_VALUES
The specified attribute is currently in the entry. The value(s) specified by DS_ATTRIBUTE_VALUES should be added to it.
- DS_REMOVE_ATTRIBUTE
The specified attribute is currently in the entry and should be deleted from the entry. Any values specified by DS_ATTRIBUTE_VALUES are ignored.
- DS_REMOVE_VALUES
The specified attribute is currently in the entry. One or more values, specified by DS_ATTRIBUTE_VALUES, should be removed from it.