Share via

3.17.4.1.31 Label (Opnum 37)

  • Article

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

 [propput] HRESULT Label(
   [in] BSTR bstrLabel
 );

bstrLabel: A BSTR that contains the application-defined string description 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 bstrLabel input parameter ≥ 250 characters:

    • Return MQ_ERROR_LABEL_TOO_LONG (0xC00E005D), and take no further action.

  • Set the represented Message.Label to the value contained in the bstrLabel input parameter.