Share via

3.11.4.1.4 Handle (Opnum 10)

  • Article

The Handle method is received by the server in an RPC_REQUEST packet. In response, the server returns the handle of the open queue.

 [propget] HRESULT Handle(
   [out, retval] long* plHandle
 );

plHandle: A pointer to a long that represents the handle of the open queue.

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 IsInitialized instance variable is False:

    • Return an error OLE_E_BLANK (0x80040007), and take no further action.

  • Set the plHandle output variable to OpenQueueDescriptor.Handle.

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