3.17.4.1.3 PrivLevel (Opnum 9)

  • 2 minutes to read

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

 [propput] HRESULT PrivLevel(
   [in] long lPrivLevel
 );

lPrivLevel: A long integer value that contains the privacy level to set. This parameter corresponds to the MQMSGPRIVLEVEL (section 2.2.2.15) enum.<148>

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 lPrivLevel input parameter is NOT a valid MQMSGPRIVLEVEL enumeration value:

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

  • Set the represented Message.PrivacyLevel to the value that maps to the MQMSGPRIVLEVEL enum contained in the lPrivLevel input parameter.