IDataAdviseHolder::SendOnDataChange メソッド (objidl.h)

アドバイズ ホルダー オブジェクトのこのインスタンスによって現在処理されている各アドバイズ シンクについて 、IAdviseSink::OnDataChange メソッドを呼び出すことによって確立された接続がある各アドバイズ シンクに通知を送信します。

構文

HRESULT SendOnDataChange(
  [in] IDataObject *pDataObject,
  [in] DWORD       dwReserved,
  [in] DWORD       advf
);

パラメーター

[in] pDataObject

データが変更されたデータ オブジェクトの IDataObject インターフェイスへのポインター。 このポインターは、 IAdviseSink::OnDataChange の後続の呼び出しで使用されます。

[in] dwReserved

このパラメーターは予約済みであり、0 である必要があります。

[in] advf

IAdviseSink::OnDataChange の呼び出し方法を指定するアドバイス フラグのコンテナー。 これらのフラグ値は、列挙 ADVF からの値です。 通常、 advf の値は NULL です。 唯一の例外は、データ オブジェクトがシャットダウンしているときに発生し、 IDataObject::D Advise の呼び出しでADVF_DATAONSTOPとADVF_NODATAを指定したシンクに実際のデータを含む最終的な通知を送信する必要があります。 この場合、 advf にはADVF_DATAONSTOPが含まれます。

戻り値

このメソッドは、成功したS_OKを返します。

注釈

データ オブジェクトは、以前に通知を要求したアドバイズ シンクにとって重要な変更を検出した場合に、このメソッドを呼び出す必要があります。

ほとんどの通知には、実際のデータが含まれます。 唯一の例外は、 IDataAdviseHolder::Advise メソッドで接続が最初に設定されたときに、ADVF_NODATA フラグが以前に指定されていた場合です。

各アドバイズ シンクに対して IAdviseSink::OnDataChange メソッドを呼び出す前に、このメソッドは pDataObject パラメーターで指定されたポインターを使用して IDataObject::GetData メソッドを呼び出して、実際のデータを取得します。

要件

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

こちらもご覧ください

IAdviseSink::OnDataChange

IDataAdviseHolder