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