3.10.4.1.22 Authenticate (Opnum 28)

The Authenticate method is received by the server in an RPC_REQUEST packet. In response, the server sets the authentication level for the referenced queue.

 [propput] HRESULT Authenticate(
   [in] long lAuthenticate
 );

lAuthenticate: A long that corresponds to one of the MQAUTHENTICATE (section 2.2.2.6) enumeration values.

Return Values: The method MUST return S_OK (0x00000000).

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

  • If the lAuthenticate input parameter equals MQ_AUTHENTICATE_NONE (0x00000000):

    • Set refQueue.Authentication to False (0x00000000).

  • Else:

    • Set refQueue.Authentication to True (0x00000001).

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