PreviousNext

DS_C_NAME

The OM class DS_C_NAME represents a name of an object in the directory, or a part of such a name.

It is an abstract class, which has the attributes of its superclass, OM_C_OBJECT, and no other OM attributes.

A name uniquely distinguishes the object from all other objects whose entries are displayed in the DIT. However, an object can have more than one name; that is, a name need not be unique. A DN is unique; there are no other DNs that identify the same object. An RDN is part of a name and only distinguishes the object from others that are its siblings.

Most of the interface functions take a name parameter, the value of which must be an instance of one of the subclasses of this OM class. Thus, this OM class is useful for amalgamating all possible representations of names.

The DCE XDS implementation defines one subclass of this OM class and, thus, a single representation for names; that is, DS_C_DS_DN, which provides a representation for names, including DNs.