3.2.6.5.5 RoutingLink

 The MQDS client MUST perform the following actions:

  1. Input arguments for the S_DSLookupNext method (section 3.1.4.18) MUST be computed:

    1. Handle MUST be the value of ReadIterator.Handle.

    2. Other arguments MUST be set up as described in section 3.1.4.18.

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

  3. If dwOutSize is 0, processing MUST end. rStatus MUST be set to DirectoryOperationResult.EndOfData and rDirectoryObject is undefined.

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

    PROPID_L_NEIGHBOR1 ([MS-MQMQ] section 2.3.7.1)

    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.

  5. Processing MUST end. rStatus MUST be set to DirectoryOperationResult.Success.