PreviousNext

DS_C_OPERATION_PROGRESS

An instance of OM class DS_C_OPERATION_PROGRESS specifies the progress or processing state of a directory request.

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_OPERATION_PROGRESS


OM Attribute

Value Syntax
Value Length Value Number Value Initially
DS_NAME_
RESOLUTION_
PHASE
Enum(DS_Name_
Resolution_Phase
)
- 1 -
DS_NEXT_
RDN_TO_BE_
RESOLVED
OM_S_INTEGER) - 0 or 1 -
The target name mentioned as follows is the name upon which processing of the directory request is currently focused.

· DS_NAME_RESOLUTION_PHASE

This attribute indicates what phase is reached in handling the target name. It must have one of the following values:

- DS_COMPLETED, meaning that the DSA holding the target object is reached.

- DS_NOT_STARTED, meaning that so far a DSA is not reached with a naming context containing the initial RDNs of the name.

- DS_PROCEEDING, meaning that the initial part of the name has been recognized, although the DSA holding the target object has not yet been reached.

· DS_NEXT_RDN_TO_BE_RESOLVED

This attribute indicates to the DSA which of the RDNs in the target name is next to be resolved. It takes the form of an integer in the range from 1 to the number of RDNs in the name. This OM attribute only has a value if the value of DS_NAME_RESOLUTION_PHASE is DS_PROCEEDING.

The constant DS_OPERATION_NOT_STARTED can be used in the DS_C_CONTEXT of an operation instead of an instance of this OM class.