Freigeben über


AfxConnectionAdvise

Rufen Sie diese Funktion auf, um eine Verbindung zwischen einer Quelle zu erstellen, der pUnkSrc und 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 die Schnittstellen-ID der Verbindung.

  • bRefCount
    TRUE gibt den an, das die Verbindung erstellt, sollte den Verweiszähler von pUnkSink bewirken erhöht werden. FALSE gibt an, dass der Verweiszähler nicht erhöht werden soll.

  • pdwCookie
    Ein Zeiger auf DWORD, in dem ein Verbindungsbezeichner zurückgegeben wird. Dieser Wert übergeben werden sollte als der Parameter dwCookie in AfxConnectionUnadvise, wenn die Verbindung getrennt.

Rückgabewert

Wert ungleich 0 (null), wenn eine Verbindung hergestellt wurde; 0 andernfalls.

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

Siehe auch

Referenz

AfxConnectionUnadvise

Konzepte

MFC-Makros, globale Funktionen und globale Variablen