3.2.6.1.5 ConnectedNetwork

 The MQDS client MUST perform the following actions:

  1.  The arguments supplied to the Create Directory Object event MUST meet the following conditions. If any of these conditions are violated, processing of the event MUST end. rStatus MUST be set to DirectoryOperationResult.GenericError and rObjectGUID is undefined.

    • If iAttributeList is provided, the Name MUST be present in the list.

    • The iDirectoryObject.Name attribute MUST be populated.

  2. If iAttributeList was not provided as an argument, then an iAttributeList MUST be constructed that MUST contain the names of all ConnectedNetwork directory attributes listed in [MS-MQDMPR] section 3.1.1.9.

  3. The aProp and apVar arguments for the S_DSCreateObject method (section 3.1.4.4) MUST be computed. For each property identifier listed in the following table, if the corresponding ConnectedNetwork attribute name appears in iAttributeList and that attribute is populated in iDirectoryObject, add the property identifier to aProp, add a PROPVARIANT to apVar that is set to the correct type for the property and contains in the correct field the computed value for the property, as shown in the following table. ConnectedNetwork attribute names that appear in iAttributeList but do not appear in the following table or subsections referenced by the table MUST be ignored.

    Property Identifier

    Property value computation

    PROPID_CN_NAME ([MS-MQMQ] section 2.3.4.2)

    UNICODE string copied from iDirectoryObject.Name.

  4. Other input arguments for the S_DSCreateObject method MUST be computed:

    1. dwObjectType MUST be MQDS_CN.

    2. pwcsPathName MUST point to a buffer containing the value of iDirectoryObject.Name.

    3. SecurityDescriptor MUST be set to NULL.

    4. Other arguments MUST be set up as described in section 3.1.4.4.

  5. The S_DSCreateObject method MUST be called with the given arguments. If the return value is not MQ_OK, processing MUST end. rStatus MUST be set to DirectoryOperationResult.GenericError and rObjectGUID is undefined.

  6. rObjectGUID MUST be set to the GUIDs returned in the buffer pointed to by the pObjGuid argument of S_DSCreateObject.

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