Share via

3.17.4.1.38 EncryptAlgorithm (Opnum 44)

  • Article

The EncryptAlgorithm method is received by the server in an RPC_REQUEST packet. In response, the server MUST return the represented Message.EncryptionAlgorithm.

 [propget] HRESULT EncryptAlgorithm(
   [out, retval] long* plEncryptAlg
 );

plEncryptAlg: A pointer to a long integer that indicates the algorithm employed by the message transfer process to encrypt or decrypt the Body. This value is not interpreted by this protocol; rather, the message transfer process interprets and validates the value. Potential values are contained in the MQCALG (section 2.2.2.18) enumeration that assigns numeric values to specific cryptographic algorithms. The message transfer implementation MAY support a subset of the encryption algorithms defined by MQCALG (section 2.2.2.18).<149>

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:

  • Set the plEncryptAlg output parameter to the MQCALG enum that maps to the value of the represented Message.EncryptionAlgorithm.