AfxConnectionAdvise

Call this function to establish a connection between a source, specified by pUnkSrc, and a sink, specified by pUnkSink.

BOOL AFXAPI AfxConnectionAdvise( 
   LPUNKNOWN pUnkSrc, 
   REFIID iid, 
   LPUNKNOWN pUnkSink, 
   BOOL bRefCount, 
   DWORD FAR* pdwCookie  
);

Parameters

  • pUnkSrc
    A pointer to the object that calls the interface.

  • pUnkSink
    A pointer to the object that implements the interface.

  • iid
    The interface ID of the connection.

  • bRefCount
    TRUE indicates that creating the connection should cause the reference count of pUnkSink to be incremented. FALSE indicates that the reference count should not be incremented.

  • pdwCookie
    A pointer to a DWORD where a connection identifier is returned. This value should be passed as the dwCookie parameter to AfxConnectionUnadvise when disconnecting the connection.

Return Value

Nonzero if a connection was established; otherwise 0.

Example

//CMySink is a CCmdTarget-derived class supporting automation. 
//Instantiate the sink class.
CMySink mysink;

//Get a pointer to sink's IUnknown, no AddRef done.
IID iid = IID_IUnknown;
IUnknown* pUnkSink = mysink.GetInterface(&iid);

//Establish a connection between source and sink. 
//pUnkSrc is IUnknown of server obtained by CoCreateInstance(). 
//dwCookie is a cookie identifying the connection, and is needed 
//to terminate this connection.
AfxConnectionAdvise(pUnkSrc, IID_ISampleSink, pUnkSink, FALSE, &dwCookie);

Requirements

Header: afxctl.h

See Also

Reference

AfxConnectionUnadvise

Concepts

MFC Macros and Globals