CBindStatusCallback::OnDataAvailable

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

システムが提供する非同期モニカは、OnDataAvailable を呼び出してオブジェクトにデータを提供し、オブジェクトでデータが使用できるようにします。

STDMETHOD(OnDataAvailable)(
   DWORD grfBSCF,
      DWORD dwSize,
      FORMATETC* /* pformatetc */,
      STGMEDIUM* pstgmed 
);

パラメータ

grfBSCF
[入力] BSCF 列挙値です。BSCF_FIRSTDATANOTIFICATION、BSCF_INTERMEDIARYDATANOTIFICATION、BSCF_LASTDATANOTIFICATION のうちの 1 つ以上になります。
dwSize
[入力] 使用可能なデータ量のバインディング開始後からの累積値です。単位はバイトです。この値が 0 の場合は、データ量が適切でないか、または特定のデータ量が使用可能にならなかったことを示します。
pformatetc
[入力] 使用可能なデータの形式を保持する FORMATETC 構造体へのポインタです。形式がない場合は、CF_NULL にできます。
pstgmed
[入力] 現時点で使用可能な実際のデータを保持する STGMEDIUM 構造体へのポインタです。

戻り値

標準の HRESULT 値のいずれかを返します。

解説

OnDataAvailable は、まずデータを読み込み、次にオブジェクトのクラスのメソッドを呼び出します。たとえば、データを保存するメソッドやデータを画面に表示するメソッドを呼び出します。詳細については、「CBindStatusCallback::StartAsyncDownload」を参照してください。