Share via

3.11.4.1.1 Access (Opnum 7)

  • Article

The Access method is received by the server in an RPC_REQUEST packet. In response, the server returns a flag that indicates the access mode in which the queue was opened. The access mode specifies whether peek, receive, send, and/or administration operations can be performed.

 [propget] HRESULT Access(
   [out, retval] long* plAccess
 );

plAccess: A pointer to a long that corresponds to one of the MQACCESS (section 2.2.2.3) 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.

  • Set the plAccess output variable to refQueue.AccessType.

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