3.1.6.14 Get Directory Object for Update

This event MUST be generated with the following arguments:

  • iObjectType: a value defined in section 2.2.8 that identifies the object type.

  • iPathName: a string that can be used to locate the directory object.

  • iGuid: a GUID that can be used to locate the directory object.

Return Values:

  • rStatus: An HRESULT indicating the result of the operation.

  • rObject: the directory object that matches the supplied arguments.

The server SHOULD<139> perform the following actions to process this event:

  • If iObjectType is MQDS_QUEUE:

    • Create a new Queue ADM element instance, and assign it to rObject.

    • Set rObject.PathName to iPathName. Set rObject.Identifier to iGuid.

  • Else If iObjectType is MQDS_MACHINE:

    • Create a new QueueManager ADM element instance and assign it to rObject.

    • Set rObject.FullPath to iPathName. Set rObject.Identifier to iGuid.

  • Else If iObjectType is MQDS_SITE:

    • Create a new Site ADM element instance, and assign it to rObject.

    • Set rObject.PathName to iPathName. Set rObject.Identifier to iGuid.

  • Else If iObjectType is MQDS_ENTERPRISE:

    • Create a new Enterprise ADM element instance, and assign it to rObject.

    • Set rObject.Name to iPathName. Set rObject.Identifier to iGuid.

  • Else If iObjectType is MQDS_USER and iGuid is not NULL:

    • Create a new User ADM element instance, and assign it to rObject.

    • Set rObject.Identifier to iGuid.

  • Else:

    • Set rStatus to a failure HRESULT, and take no further action.

  • Set rStatus to 0x00000000.