PreviousNext

DS_C_SEARCH_RESULT

An instance of OM class DS_C_SEARCH_RESULT comprises the result of a successful call to ds_search( ).

An application is not permitted to create or modify instances of this OM class. An instance of this OM class has the OM attributes of its superclass, OM_C_OBJECT, in addition to the OM attributes listed in the following table.


OM Attributes of DS_C_SEARCH_RESULT


OM Attribute

Value Syntax
Value Length Value Number Value Initially
DS_SEARCH_INFO Object(DS_C_
SEARCH_INFO
)
- 0 or 1 -
DS_
UNCORRELATED_
SEARCH_INFO
Object(DS_C_
SEARCH_
RESULT
)
- 0 or more -
Note: No instance contains values of both OM attributes.

· DS_SEARCH_INFO

This attribute contains the full result of ds_search( ), or part of the result.

· DS_UNCORRELATED_SEARCH_INFO

When the DUA requests a protection request of signed, the information returned can comprise a number of sets of results originating from and signed by different components of the directory service. Implementations can reflect this structure by nesting DS_C_SEARCH_RESULT OM objects as values of this OM attribute. Alternatively, they can collapse all results into a single value of the OM attribute DS_SEARCH_INFO. The DCE directory service does not support the optional feature of signed results; therefore, this OM attribute is never present.