3.2.6.5.5 RoutingLink
The MQDS client MUST perform the following actions:
Input arguments for the S_DSLookupNext method (section 3.1.4.18) MUST be computed:
Handle MUST be the value of ReadIterator.Handle.
Other arguments MUST be set up as described in section 3.1.4.18.
The S_DSLookupNext method MUST be called. If the return value is not MQ_OK, processing MUST end. rStatus MUST be set to DirectoryOperationResult.GenericError and rDirectoryObject is undefined.
If dwOutSize is 0, processing MUST end. rStatus MUST be set to DirectoryOperationResult.EndOfData and rDirectoryObject is undefined.
A RoutingLink data element MUST be created. rDirectoryObject MUST be set to this new RoutingLink data element. The attributes listed in ReadIterator.AttributeList MUST be set on rDirectoryObject according to the following table. The property values required are in the PROPVARIANT array pointed to by pbBuffer and are in the same order as the property identifiers in ReadIterator.PropidList.
RoutingLink attribute
Property identifier
Attribute value computation
Site1Identifier
GUID copied from property.
Site2Identifier
PROPID_L_NEIGHBOR2 ([MS-MQMQ] section 2.3.7.2)
GUID copied from property.
Cost
PROPID_L_COST ([MS-MQMQ] section 2.3.7.3)
Integer copied from property.
Identifier
PROPID_L_ID ([MS-MQMQ] section 2.3.7.6)
GUID copied from property.
SiteGateIdentifierList
PROPID_L_GATES ([MS-MQMQ] section 2.3.7.13)
List of GUIDs copied from property.
Site1FullPath
PROPID_L_NEIGHBOR1_DN ([MS-MQMQ] section 2.3.7.8)
Unicode string copied from property.
Site2FullPath
PROPID_L_NEIGHBOR2_DN ([MS-MQMQ] section 2.3.7.9)
Unicode string copied from property.
Description
PROPID_L_DESCRIPTION ([MS-MQMQ] section 2.3.7.10)
Unicode string copied from property.
FullPath
PROPID_L_FULL_PATH ([MS-MQMQ] section 2.3.7.11)
Unicode string copied from property.
ActualCost
PROPID_L_ACTUAL_COST ([MS-MQMQ] section 2.3.7.12)
Integer copied from property.
Processing MUST end. rStatus MUST be set to DirectoryOperationResult.Success.