In general, the objects you work with in an XDS/CDS application fall into two categories:
· Objects you have to supply as input parameters to XDS functions
· Objects returned to you as output by XDS functions
This topic describes only the first category, since you have to construct these input objects yourself.
The table below shows XDS functions and the objects given to them as input parameters.
Only items significant to CDS are listed in the table. DS_C_SESSION and DS_C_CONTEXT are ignored. DS_C_SESSION is returned by ds_bind( ), which usually receives the DS_DEFAULT_SESSION constant as input. DS_C_CONTEXT is usually substituted by the DS_DEFAULT_CONTEXT constant.
Note: DS_C_NAME is an abstract class that has the single subclass DS_C_DS_DN. Therefore, DS_C_NAME is practically the same thing as DS_C_DS_DN.
Directory Service Functions with their Required Input Objects
| Function | Input Object |
| ds_add_entry( ) | DS_C_NAME |
| DS_C_ATTRIBUTE_LIST | |
| ds_bind( ) | None |
| ds_compare( ) | DS_C_NAME |
| DS_C_AVA | |
| ds_initialize( ) | None |
| ds_list( ) | DS_C_NAME |
| ds_modify_entry( ) | DS_C_NAME |
| DS_C_ENTRY_MOD_LIST | |
| ds_read( ) | DS_C_NAME |
| DS_C_ENTRY_INFO_SELECTION | |
| ds_remove_entry( ) | DS_C_NAME |
| ds_shutdown( ) | None |
| ds_unbind( ) | None |
| ds_version( ) | None |