PreviousNext

DS_C_SEARCH_INFO

An instance of OM class DS_C_SEARCH_INFO is part of the result of 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 superclasses, OM_C_OBJECT and DS_C_COMMON_RESULTS, in addition to the OM attributes listed in the following table.


OM Attributes of DS_C_SEARCH_INFO


OM Attribute

Value Syntax
Value Length Value Number Value Initially
DS_ENTRIES Object(DS_C_
ENTRY_INFO
)
- 0 or more -
DS_OBJECT_
NAME
Object(DS_C_
NAME
)
- 0 or 1 -
DS_PARTIAL_
OUTCOME_
QUAL
Object(DS_C_
PARTIAL_
OUTCOME_
QUAL
)
- 0 or 1 -
· DS_ENTRIES

This attribute contains information about zero or more objects found by ds_search( ) that matched the given selection criteria.

· DS_OBJECT_NAME

This attribute contains the DN of the target object of the operation. It is present if the OM attribute DS_ALIAS_DEREFERENCED, inherited from the superclass DS_C_COMMON_RESULTS, is OM_TRUE.

· DS_PARTIAL_OUTCOME_QUAL

This OM attribute value is only present if the list of entries is incomplete. The DSA or DSAs that provided this list did not complete the search for some reason. The partial outcome qualifier contains details of why the search was not completed and which areas of the directory were not searched.