The following subtopics contain information about all the object types required as input to any of the XDS functions that can be used to access the CDS. In order to use these functions successfully, you must be able to construct and modify the objects that the functions expect as their input parameters. XDS functions require most of their input parameters to be wrapped in a nested series of data structures that represent objects, and these functions deliver their output returns to callers in the same object form.
Objects that are returned to you by the interface are not difficult to manipulate because the om_get( ) function allows you to go through them and retrieve only the value parts you are interested in, and discard the parts of data structures you are not interested in. However, any objects you are required to supply as input to an XDS or XOM function are another matter: you must build and initialize these object structures yourself.
The basics of object building have already been explained earlier in this topic. Each object described in the following subtopics is accompanied by a static declaration in C of a very simple instance of that object class. The objects in an application are usually built dynamically (this technique was demonstrated earlier in this topic). The static declarations that follow give a simple example of what the objects look like.
An object's properties, such as what sort of values it can hold, how many of them it can hold, and so on, are determined by the class the object belongs to. Each class consists of one or more attributes that an object can have. The attributes hold whatever values the object contains. Thus, the objects are data structures that all look the same (and can be handled in the same way) from the outside, but whose specific data fields are determined by the class each object belongs to. At the abstract level, objects consist of attributes, just as structures consist fields.
More:
The DS_C_ATTRIBUTE_LIST Object
Example Definition of a DS_C_ATTRIBUTE_LIST Object
Example Definition of a DS_C_DS_DN Object
The DS_C_ENTRY_MOD_LIST Object
Example Definition of a DS_C_ENTRY_MOD_LIST Object
The DS_C_ENTRY_INFO_SELECTION Object
Example Definition of a DS_C_ENTRY_INFO_SELECTION Object