3.2.4.11 Cancel a Pending Peek or Receive

The message queuing application MUST specify the QUEUE_CONTEXT_HANDLE_NOSERIALIZE (section 2.2.4.1) handle and the dwRequestId parameter of the operation to be canceled.

  • The client MUST call the R_CancelReceive (Opnum 8) (section 3.1.4.8) method and MUST specify the following parameter values:

    • The phContext parameter set to a QUEUE_CONTEXT_HANDLE_NOSERIALIZE handle that has been returned by the server in the pphQueue output parameter of a prior call to the R_OpenQueue (Opnum 2) (section 3.1.4.2) method and that MUST NOT have been previously closed through a call to the R_CloseQueue (Opnum 3) (section 3.1.4.3) method. This value MUST NOT be NULL.

    • The dwRequestId parameter set to the dwRequestId parameter passed by the message queuing application.