Share via

3.12.4.1.3 IsOpen (Opnum 9)

  • Article

The IsOpen method is received by the server in an RPC_REQUEST packet. In response, the server returns a Boolean value indicating whether the MSMQDestination object is open for sending messages.

 [propget] HRESULT IsOpen(
   [out, retval] VARIANT_BOOL* pfIsOpen
 );

pfIsOpen: A pointer to a VARIANT_BOOL that, when set to VARIANT_TRUE (0xffff), indicates that the object is open. Otherwise, when set to VARIANT_FALSE (0x0000), it indicates that the object is closed.

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 DestinationOpenQueueDescriptor instance variable equals NULL:

    • Set the pfIsOpen output parameter to VARIANT_FALSE (0x00000000).

  • Else:

    • Set the pfIsOpen output parameter to VARIANT_ TRUE (0x00000001).

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