CBindStatusCallback::OnDataAvailable

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

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

See Also

Reference

CBindStatusCallback Class

CBindStatusCallback::StartAsyncDownload