AfxConnectionAdvise

  • [アーティクル]

更新 : 2007 年 11 月

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
    接続 ID が返される DWORD へのポインタ。この値は接続を切り離すときに AfxConnectionUnadvise へのパラメータ dwCookie に渡します。

戻り値

接続が確立された場合は 0 以外を返します。それ以外の場合は 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

参照

概念

MFC マクロとグローバル

参照

AfxConnectionUnadvise