IOleObject::EnumAdvise メソッド (oleidl.h)

オブジェクトに登録されているアドバイザリ接続を列挙するために使用できる列挙子へのポインターを取得し、コンテナーが終了する前に解放する内容を把握できるようにします。

構文

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

パラメーター

[out] ppenumAdvise

列挙子オブジェクトへのインターフェイス ポインターを受け取る IEnumSTATDATA ポインター変数のアドレス。 オブジェクトにアドバイザリ接続がない場合、またはエラーが発生した場合は、実装で ppenumAdvise を NULL に設定する必要があります。 オブジェクトが IOleObject::EnumAdvise の呼び出しに成功するたびに、 ppenumAdvise の参照カウントを増やす必要があります。 呼び出し元は、 ppenumAdvise で完了したときに Release を呼び出す必要があります。

戻り値

このメソッドは、成功したS_OKを返します。 その他の可能な戻り値は次のとおりです。

注釈

IOleObject::EnumAdvise メソッドは、コンテナーがオブジェクトに登録されているアドバイザリ接続を追跡する方法を提供する列挙子を提供します。 コンテナーは通常、この関数を呼び出して、閉じる前に各アドバイザリ接続を解放するようにオブジェクトに指示できるようにします。

IOleObject::EnumAdvise を介してアクセスできる列挙子は、STATDATA 型の項目を列挙します。 ポインターを受け取ると、コンテナーは STATDATA をループ処理し、列挙された接続ごとに IOleObject::Unadvise を呼び出すことができます。

この関数を実装する通常の方法は、呼び出しを IOleAdviseHolder インターフェイスに委任することです。 STATDATA の pAdvise メンバーと dwConnection メンバーのみが IOleObject::EnumAdvise に関連します。

要件

こちらもご覧ください

IOleObject

IOleObject::Advise

IOleObject::Unadvise