3.10.4.1.25 IsWorldReadable (Opnum 31)

  • Article

The IsWorldReadable method is received by the server in an RPC_REQUEST packet. In response, the server returns a BOOLEAN that indicates whether the referenced queue is accessible to everyone, or only to the owner and the system administrators. This can be computed through the security descriptor in the Queue.Security attribute. The owner is the security principal that has MQSEC_TAKE_QUEUE_OWNERSHIP permissions for the Queue, as defined by the security descriptor in the refQueue.Security attribute.

 [propget] HRESULT IsWorldReadable(
   [out, retval] short* pisWorldReadable
 );

pisWorldReadable: A pointer to a short that indicates whether the referenced queue is accessible to everyone or only to the owner and the system administrators.

Return Values: The method MUST return S_OK (0x00000000).

When processing this call, the server MUST abide by the following contract:

  • If only the owner security principal has MQSEC_TAKE_QUEUE_OWNERSHIP permissions for the referenced queue in the security descriptor in the refQueue.Security attribute:

    • Set the pisWorldReadable output parameter to the value of False.

  • Else:

    • Set the pisWorldReadable output parameter to the value of the True.

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