Share via

3.17.4.1.5 AuthLevel (Opnum 11)

  • Article

The AuthLevel method is received by the server in an RPC_REQUEST packet. In response, the server MUST set the value of the RequestedAuthenticationLevel instance variable.

 [propput] HRESULT AuthLevel(
   [in] long lAuthLevel
 );

lAuthLevel: A long integer that identifies the authentication level of the message. This parameter corresponds to the MQMSGAUTHLEVEL (section 2.2.2.16) enum.

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

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

  • Set the RequestedAuthenticationLevel instance variable to the value that maps to the MQMSGAUTHLEVEL enum contained in the lAuthLevel input parameter.