Share via

3.11.4.1.2 ShareMode (Opnum 8)

  • Article

The ShareMode method is received by the server in an RPC_REQUEST packet. In response, the server returns a flag that indicates the share mode in which the queue was opened. The share mode specifies whether this instance of the open queue has exclusive access to the queue.

 [propget] HRESULT ShareMode(
   [out, retval] long* plShareMode
 );

plShareMode: A pointer to a long that corresponds to one of the MQSHARE (section 2.2.2.2) enumeration values.

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

When processing this call, the server MUST follow these guidelines:

  • If the IsInitialized instance variable is False:

    • Return an error OLE_E_BLANK (0x80040007), and take no further action.

  • If the refQueue.shareMode equals DenyReceive:

    • Set the plShareMode output variable to MQ_DENY_RECEIVE_SHARE (0x00000001).

  • Else:

    • Set the plShareMode output variable to MQ_DENY_NONE (0x00000000).

  • Return S_OK (0x00000000), and take no further action.