AfxConnectionAdvise
呼叫這個函式會建立來源之間的連接,由 pUnkSrc和接收,指定由 pUnkSink。
BOOL AFXAPI AfxConnectionAdvise(
LPUNKNOWN pUnkSrc,
REFIID iid,
LPUNKNOWN pUnkSink,
BOOL bRefCount,
DWORD FAR* pdwCookie
);
參數
pUnkSrc
呼叫介面之物件的指標。pUnkSink
呼叫實做介面之物件的指標。iid
連結的介面 ID。bRefCount
TRUE 表示建立連接應該導致參考 pUnkSink 的計數會遞增。 FALSE 表示不應該加入參考計數。pdwCookie
對連接識別項傳回之 DWORD 的指標。 在中斷連接時,應該將這個值當做 dwCookie 參數為 AfxConnectionUnadvise 。
傳回值
如果已建立連接則為非零;否則為 0。
範例
//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);
需求
標頭: afxctl.h