DS_C_DS_RDN class objects are required as values for the DS_RDNS attributes of DS_C_DS_DN objects. (For an illustration of its structure, see the figure, DS_C_DS_DN Object Attributes.) RDN refers to the X.500 term RDN that is used to signify a part of a full entry name. Separate objects of this class are not usually required as input to XDS functions.
The standard permits multiple AVAs in an RDN, but the DCE Directory and XDS API restrict an RDN to one AVA.
· OM_CLASS
The value of this attribute is an OID string that identifies the object's class; its value is always DS_C_DS_RDN.
· DS_AVAS
This is an attribute whose value is yet another object of class DS_C_AVA (see The DS_C_AVA Object). The DS_C_AVA object is defined by a separate array of object descriptors whose base address is the value of the DS_AVAS attribute.
Note that there can only be one instance of this attribute in the DS_C_RDN object. The object descriptor array describing this object always consists of three object descriptor structures: the first describes the object's class, the second describes the DS_AVAS attribute, and the third descriptor is the terminating NULL.