Share via

3.10.4.1.18 BasePriority (Opnum 24)

  • Article

The BasePriority method is received by the server in an RPC_REQUEST packet. In response, the server sets the default priority of the referenced queue.

 [propput] HRESULT BasePriority(
   [in] long lBasePriority
 );

lBasePriority: A long that specifies the default priority of the referenced queue.

Return Values: The method MUST return S_OK (0x00000000) on success or MQ_ERROR_ILLEGAL_PROPERTY_VALUE (0xC00E0018) on failure.

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

  • If the lBasePriority input parameter is a value between –32768 and +32767:

    • If QueueFormatName starts with: "PUBLIC=":

      • Set refQueue.BasePriority to the value of the lBasePriority input parameter.

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

    • Else:

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

  • Else:

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