IDataObject::EnumDAdvise メソッド (objidl.h)

  • [アーティクル]

現在のアドバイザリ コネクションを列挙するために使用できるオブジェクトを作成します。

構文

HRESULT EnumDAdvise(
  [out] IEnumSTATDATA **ppenumAdvise
);

パラメーター

[out] ppenumAdvise

新しい列挙子オブジェクトへのインターフェイス ポインターを受け取る IEnumSTATDATA ポインター変数へのポインター。 実装で *ppenumAdvise が NULL に設定されている場合、現時点ではシンクにアドバイスする接続はありません。

戻り値

このメソッドは、列挙子オブジェクトが正常にインスタンス化された場合、または接続がない場合にS_OKを返します。 その他の使用可能な値は次のとおりです。

リターン コード 説明
E_OUTOFMEMORY
 操作に使用できるメモリが不足しています。
OLE_E_ADVISENOTSUPPORTED
 アドバイザリ通知は、このオブジェクトではサポートされていません。

注釈

このメソッドによって作成された列挙子オブジェクトは、 IEnumSTATDATA インターフェイスを 実装します。 IEnumSTATDATA では、STATDATA 構造体の配列に格納されているデータの列挙を許可します。 これらの各構造体は、1 つのアドバイザリ接続に関する情報を提供し、 FORMATETC と ADVF 情報、およびアドバイザリ シンクへのポインターと接続を表すトークンを含みます。

呼び出し元へのメモ

アドバイザリ接続を処理するには、OLE データ アドバイザリ ホルダー オブジェクトを使用することをお勧めします。 CreateDataAdviseHolder の呼び出しによって取得されたポインターを使用すると、IDataObject::EnumDAdvise の実装は、IDataAdviseHolder::EnumAdvise への呼び出しを委任する単純な問題になります。 これにより、列挙子が作成され、 IEnumSTATDATA の OLE 実装へのポインターが提供されます。 その時点で、そのメソッドを呼び出して、現在のアドバイザリ接続を列挙できます。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー objidl.h

こちらもご覧ください

IDataAdviseHolder::EnumAdvise

Idataobject

IEnumSTATDATA