3.17.4.1.29 Ack (Opnum 35)

  • Article

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

 [propput] HRESULT Ack(
   [in] long lAck
 );

lAck: A long integer that specifies the type of acknowledgments requested for the message. This parameter corresponds to the MQMSGACKNOWLEDGEMENT (section 2.2.2.11) 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 lAck input parameter is NOT a valid MQMSGACKNOWLEDGEMENT enumeration value:

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

  • Set the represented Message.AcknowledgementsRequested to the value that maps to the MQMSGACKNOWLEDGEMENT enum contained in the lAck input parameter.