AfxConnectionAdvise
Rufen Sie diese Funktion auf, um eine Verbindung zwischen einem Quell- und pUnkSrc festzulegen, angegeben durch eine Senke, angegeben durch pUnkSink.
BOOL AFXAPI AfxConnectionAdvise(
LPUNKNOWN pUnkSrc,
REFIID iid,
LPUNKNOWN pUnkSink,
BOOL bRefCount,
DWORD FAR* pdwCookie
);
Parameter
pUnkSrc
Ein Zeiger auf das Objekt, das die Schnittstelle aufruft.pUnkSink
Ein Zeiger auf das Objekt, das die Schnittstelle implementiert.iid
Die Schnittstellen-ID der Verbindung.bRefCount
TRUE gibt an, das die Verbindung erstellt, sollte der Verweiszähler inkrementiert werden soll pUnkSink von bewirken.FALSE gibt an, dass der Verweiszähler nicht erhöht werden soll.pdwCookie
Ein Zeiger auf DWORD, in dem ein Bezeichner der Verbindung zurückgegeben wird.Dieser Wert sollte übergeben werden als dwCookie-Parameter in AfxConnectionUnadvise, wenn die Verbindung trennt.
Rückgabewert
Ungleich 0 (null), wenn eine Verbindung hergestellt wurde; andernfalls 0.
Beispiel
//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);
Anforderungen
Header: afxctl.h