IDataObject_DAdvise

アドバイスシンクをサポートするオブジェクトから呼び出され、データオブジェクトとアドバイスシンクとの間に接続を作成する。これによりアドバイスシンクがオブジェクトのデータの変更を通知できるようになる。

IDataObject_DAdvise this, pformatetc, advf, pAdvSink, pdwConnection

this : [comobj] IDataObject インターフェースの COM オブジェクト変数
pformatetc : [var] 今後の通知で使用する形式、ターゲットデバイス、アスペクト、メディウムを定義する FORMATETC 構造体へのポインター。例えばあるシンクはデータオブジェクト内のデータのビットマップ表現が変更されたときのみ通知を受けたいかもしれない。別のシンクは同じオブジェクトのメタファイル形式にのみ関心を持つかもしれない。各アドバイスシンクは関心のあるデータが変更されたときに通知される。このデータは通知発生時にアドバイスシンクに渡される。
advf : [int] アドバイザリ接続を制御するフラグの組み合わせ。取り得る値は ADVF 列挙子から来る。ただしこのメソッドに関係するのは可能な ADVF 値の一部のみである。以下の表は関連する値を簡単に説明する。
pAdvSink : [comobj] 変更通知を受け取るアドバイスシンク上の IAdviseSink インターフェースへのポインター。
pdwConnection : [int] この接続を識別するトークン。このトークンは後でアドバイザリ接続を削除する際（IDataObject::DUnadvise に渡す）に使える。この値が 0 の場合、接続は確立されなかったことを意味する。

(プラグイン / モジュール : com_misc.dll)

解説

アドバイスシンクをサポートするオブジェクトから呼び出され、データオブジェクトとアドバイスシンクとの間に接続を作成する。これによりアドバイスシンクがオブジェクトのデータの変更を通知できるようになる。

[戻り値]
成功時は S_OK を返す。その他の値には以下のものが含まれる。
（以下省略）

[備考]
DAdvise
はデータオブジェクトと呼び出し側との間に変更通知接続を作成する。呼び出し側は、オブジェクトのデータが変更されたときに通知を送信できるアドバイザリシンクを提供する。単にデータ転送に使われるオブジェクトは通常アドバイザリ通知をサポートせず、DAdvise
から OLE_E_ADVISENOTSUPPORTED を返す。呼び出し側へのメモ アドバイスシンクをサポートするオブジェクトは、渡された
FORMATETC 構造体で対象の形式、アスペクト、メディウム、ターゲットデバイスを指定して DAdvise
を呼び出し、接続を確立する。データオブジェクトが要求された属性のいずれかをサポートしないか、通知の送信自体をサポートしない場合、OLE_E_ADVISENOTSUPPORTED
を返して接続を拒否できる。リンクオブジェクトのコンテナーは、バインド済みのリンクソースと直接アドバイザリ接続を確立することもできるし、接続を管理する標準
OLE
リンクオブジェクトを介して間接的に確立することもできる。バインド済みリンクソースと確立した接続は自動的に削除されない。コンテナーはアドバイザリ接続を削除するために明示的にバインド済みリンクソースで
IDataObject::DUnadvise を呼び出さなければならない。IOleLink インターフェース経由で操作される OLE
リンクオブジェクトは既定ハンドラー内に実装されている。OLE
リンクオブジェクトを介して確立された接続はリンクオブジェクトの削除時に破棄される。OLE
既定のリンクオブジェクトはリンクソースと「ワイルドカードアドバイス」を作成して、OLE
が最終変更時刻を保持できるようにする。このアドバイスは何かが変更された時刻を記録するために特別に使用される。OLE
は変更された可能性のあるすべてのデータ形式を無視し、最終変更時刻のみを記録する。ワイルドカードアドバイスを許可するには、DAdvise
の呼び出し前に FORMATETC メンバーを以下のように設定する。
（以下省略）

情報