3.16.4.5.1 GetConnectionInterface (Opnum 3)

  • Article

The GetConnectionInterface method is received by the server in an RPC_REQUEST packet. In response, the server MUST return a pointer to the IID of the interface that client applications MUST implement for the MSMQEvent object to be able to notify them when an event is raised.

 HRESULT GetConnectionInterface(
   [out] IID* pIID
 );

pIID: A pointer to an IID that upon successful completion will contain the IID value of the _DMSMQEventEvents interface.

Return Values: The method MUST return S_OK (0x00000000) on success or an implementation-specific error HRESULT on failure.<92>

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

  • If the pIID output parameter equals NULL:

    • Return E_POINTER (0x80000005).

  • Else:

    • Set the pIID output parameter to the IID for the _DMSMQEventEvents interface (D7D6E078-DCCD-11d0-AA4B-0060970DEBAE).