Priority (Opnum 18)

The Priority method is received by the server in an RPC_REQUEST packet. In response, the server MUST set the represented Message.Priority.

 [propput] HRESULT Priority(
   [in] long lPriority

lPriority: A long integer that specifies the priority of the message.

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 lPriority input parameter is NOT in the range 0 ≤ lPriority ≤ 7:

    • Return MQ_ERROR_ILLEGAL_PROPERTY_VALUE (0xC00E0018), and take no further action.

  • Set the represented Message.Priority to the value contained in the lPriority input parameter.