3.10.4.1.15 Quota (Opnum 21)

The Quota method is received by the server in an RPC_REQUEST packet. In response, the server returns the maximum size, in kilobytes, of the referenced queue.

 [propget] HRESULT Quota(
   [out, retval] long* plQuota
 );

plQuota: A pointer to a long that specifies the maximum size, in kilobytes, of the referenced 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 abide by the following contract:

  • If IsRefreshed is FALSE call Refresh (section 3.10.4.1.29).

  • If Refresh returns a value other than S_OK (0x00000000), return the HRESULT returned by Refresh and take no further action.

  • If IsApplicationQueue is True:

    • Set the plQuota output parameter to the value of refQueue.Quota.

  • Else:

    • Set the plQuota output parameter to 0xffffffff.

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