HRESULT Download( T* pT, ATL_PDATAAVAILABLE pFunc, BSTR bstrURL, IUnknown* pUnkContainer = NULL, BOOL bRelative = FALSE );
Return Value
One of the standard HRESULT values.
Parameters
pT
[in] A pointer to the object requesting the asynchronous data transfer. The CBindStatusCallback object is templatized on this object's class.
pFunc
[in] A pointer to the function that receives the data that is read. The function is a member of your object's class of type T. See StartAsyncDownload for syntax and an example.
bstrURL
[in] The URL to obtain data from. Can be any valid URL or file name. Cannot be NULL. For example:
CComBSTR mybstr =_T("http://somesite/data.htm")
pUnkContainer
[in] The IUnknown of the container. NULL by default.
bRelative
[in] A flag indicating whether the URL is relative or absolute. FALSE by default, meaning the URL is absolute.
Remarks
Creates a CBindStatusCallback object and calls StartAsyncDownload to start downloading data asynchronously from the specified URL. Every time data is available it is sent to the object through OnDataAvailable. OnDataAvailable reads the data and calls the function pointed to by pFunc (for example, to store the data or print it to the screen).