3.1.5.2.2.1 INtmsNotifySink::ConnectCallback (Opnum 3)

  • Article

The ConnectCallback method connects a connection point to the sink. 

 HRESULT ConnectCallback(
   [in] IUnknown* pUnkCP,
   [in] IUnknown* pUnkSink
 );

pUnkCP: A pointer to the IUnknown interface ([MS-DCOM] section 3.1.1.5.8) of the connection point.

pUnkSink: A pointer to the IUnknown interface of the sink.

Return value/code

Description

0x00000000

S_OK

The method completed successfully.

0x80070057

ERROR_INVALID_PARAMETER

A parameter is missing.

Upon receiving this message, the client sink MUST verify that both pUnkCP and pUnkSink are not NULL. If parameter validation fails, the server MUST immediately fail the operation and return ERROR_INVALID_PARAMETER (0x80070057).

Otherwise, the client MUST create a connection between the connection point of a client object (that is, pUnkCP) and a client's sink and return S_OK.

The client MUST save a cookie that uniquely identifies the connection.