PreviousNext

The DS_C_ENTRY_MOD_LIST Object

DS_C_ENTRY_MOD_LIST class objects, which contain a list of changes to be made to some directory entry, must be passed to ds_modify_entry( ). DS_C_ENTRY_MOD_LIST objects have the attributes shown in the following figure.


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_LIST.

· DS_CHANGES

This is an attribute whose value is another object of class DS_C_ENTRY_MOD (see The DS_C_ENTRY_MOD Object). The DS_C_ENTRY_MOD object is defined by a separate array of object descriptors whose base address is the value of the DS_CHANGES attribute.

Note that there can be one or more instances of this attribute in the object, which is why it is called _LIST. Each attribute contains one separate entry modification. To learn how the modification itself is specified, see The DS_C_ENTRY_MOD Object. The order of multiple instances of this attribute is significant because if more than one modification is specified, the modifications are performed by ds_modify_entry( ) in the order in which the DS_CHANGES attributes appear in the DS_C_ENTRY_MOD_LIST object.