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 | - |
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.