CBindStatusCallback::OnDataAvailable

Article
12/01/2015

The system-supplied asynchronous moniker calls OnDataAvailable to provide data to the object as it becomes available.

Syntax

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

Parameters

grfBSCF
[in] A BSCF enumeration value. One or more of the following: BSCF_FIRSTDATANOTIFICATION, BSCF_INTERMEDIARYDATANOTIFICATION, or BSCF_LASTDATANOTIFICATION.
dwSize
[in] The cumulative amount (in bytes) of data available since the beginning of the binding. Can be zero, indicating that the amount of data is not relevant or that no specific amount became available.
pformatetc
[in] Pointer to the FORMATETC structure that contains the format of the available data. If there is no format, can be CF_NULL.
pstgmed
[in] Pointer to the STGMEDIUM structure that holds the actual data now available.

Return Value

One of the standard HRESULT values.

Remarks

OnDataAvailable reads the data, then calls a method of your object's class (for example, to store the data or print it to the screen). See CBindStatusCallback::StartAsyncDownload for details.

Requirements

Header: atlctl.h

Share via