Read functions retrieve information from specific named entries in the directory where names are mapped to attributes. This is analogous to looking up some information about a name in the White Pages phone directory.
XDS API implements the following read functions:
· ds_read( )
The requestor supplies a distinguished name and one or more attribute types. The value(s) of requested attributes or just the attribute type(s) is returned by the DSA.
· ds_compare( )
The requestor gives a distinguished name and an Attribute Value Assertion (AVA). If the AVA is TRUE for the named entry, a value of TRUE is returned by the DSA.
For example, a typical read operation could request the telephone number of a particular employee. A read request would submit the distinguished name of the employee with an indication to return its telephone number: /C=us/O=sni/OU=sales/CN=John Smith.
More:
Reading an Entry from the Directory
Step 1: Export Object Identifiers for Required Directory Classes and Attributes
Step 2: Declare Local Variables
Step 4: Create an Entry-Information-Selection Parameter
Step 5: Perform the Read Operation