3.2.4.7 Purging a Queue
The message queuing application MUST specify the QUEUE_CONTEXT_HANDLE_NOSERIALIZE (section 2.2.4.1) handle of the queue. The client MUST call the R_PurgeQueue (Opnum 6) (section 3.1.4.6) method with 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.