3.12.4.1.2 Close (Opnum 8)

The Close method is received by the server in an RPC_REQUEST packet. In response, the server closes the Queues identified by the QueueFormatName instance variable.

 HRESULT Close();

This method has no parameters.

Return Values: The method MUST return S_OK (0x00000000) on success, S_FALSE (0x00000001) if the object is already closed, or an implementation-specific error HRESULT on failure.

When processing this call, the server MUST follow these guidelines:

  • If the DestinationOpenQueueDescriptor instance variable equals NULL:

    • Return S_FALSE (0x00000001), and take no further action.

  • Generate the Close Queue event with the following arguments:

    • iQueueDesc = DestinationOpenQueueDescriptor.

  • Set the DestinationOpenQueueDescriptor instance variable to NULL.

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