An instance of OM class DS_C_PARTIAL_OUTCOME_QUAL explains to what extent the results of a call to ds_list( ) or ds_search( ) are incomplete and why.
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 a DS_C_PARTIAL_OUTCOME_QUAL
OM Attribute |
Value Syntax |
Value Length | Value Number | Value Initially |
DS_LIMIT_ PROBLEM |
Enum(DS_Limit_ Problem) |
- | 1 | - |
DS_ UNAVAILABLE_ CRIT_EXT |
OM_S_BOOLEAN | - | 1 | - |
DS_ UNEXPLORED |
Object(DS_C_ CONTINUATION_ REF) |
- | 0 or more | - |
This attribute explains fully or partly why the results are incomplete. It can have one of the following values:
- DS_ADMIN_LIMIT_EXCEEDED, meaning that an administrative limit is reached.
- DS_NO_LIMIT_EXCEEDED, meaning that there is no limit problem.
- DS_SIZE_LIMIT_EXCEEDED, meaning that the maximum number of objects specified as a service control is reached.
- DS_TIME_LIMIT_EXCEEDED, meaning that the maximum number of seconds specified as a service control is reached.
· DS_UNAVAILABLE_CRIT_EXT
If OM_TRUE, this attribute indicates that some part of the directory service cannot provide a requested critical service extension. The user requested one or more standard service extensions by including values of the OM attribute DS_EXT in the DS_C_CONTEXT supplied for the operation. Furthermore, the user indicated that some of these extensions are essential by setting the OM attribute DS_CRIT in the extension to OM_TRUE. Some of the critical extensions cannot be performed by one particular DSA or by a number of DSAs. In general, it is not possible to determine which DSA could not perform which particular extension.
· DS_UNEXPLORED
This attribute identifies any regions of the directory that are left unexplored in such a way that the directory request can be continued. Only continuation references within the scope specified by the DS_SCOPE_OF_REFERRAL service control are included.