Share via

3.3.4.1.3 Machine (Opnum 9)

  • Article

The Machine method is received by the server in an RPC_REQUEST packet. In response, the server MUST return the QueueManager.ComputerName that owns the represented Queue.

 [propget] HRESULT Machine(
   [out, retval] BSTR* pbstrMachine
 );

pbstrMachine: A pointer to a BSTR that, when successfully completed, contains the QueueManager.ComputerName that owns the represented Queue.

Return Values: The method MUST return S_OK (0x00000000) to indicate success or an implementation-specific error HRESULT on failure.

When the server processes this call, it MUST follow these guidelines:

  • If the ObjectIsInitialized instance variable is False:

    • Return MQ_ERROR_UNINITIALIZED_OBJECT (0xC00E0094), and take no further action.

  • If the ComputerName instance variable is NULL:

    • Set the pbstrMachine output variable to the local QueueManager.ComputerName.

  • Else:

    • Set the pbstrMachine output variable to the value of the ComputerName instance variable.