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 へのポインター。この値は AfxConnectionUnadvise に dwCookie パラメーターとして接続をドロップしたときに渡す必要があります。

戻り値

接続が確立されている場合以外; それ以外の場合は 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

参照

関連項目

AfxConnectionUnadvise

概念

MFC マクロとグローバル