PreviousNext

DS_C_PARTIAL_OUTCOME_QUAL

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 -
· DS_LIMIT_PROBLEM

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.