Share via

3.11.4.1.20 Handle2 (Opnum 26)

  • Article

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

 [propget] HRESULT Handle2(
   [out, retval] VARIANT* pvarHandle
 );

pvarHandle: A pointer to a VARIANT of type VT_I8 (0x00000014) that represents 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 pvarHandle output variable to OpenQueueDescriptor.Handle.

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