CBindStatusCallback::Download

  • [アーティクル]

更新 : 2007 年 11 月

CBindStatusCallback オブジェクトを作成した後、StartAsyncDownload を呼び出して、指定された URL からデータを非同期にダウンロードします。

static HRESULT Download(
      T* pT,
      ATL_PDATAAVAILABLE pFunc,
      BSTR bstrURL,
      IUnknown* pUnkContainer = NULL,
      BOOL bRelative = FALSE 
);

パラメータ

  • pT
    [入力] 非同期データ転送を要求しているオブジェクトへのポインタです。CBindStatusCallback オブジェクトは、このオブジェクトのクラスのテンプレートとなります。

  • pFunc
    [入力] 読み込まれるデータを受け取る関数へのポインタです。この関数は、オブジェクトの T 型のクラスのメンバです。構文と例については、「StartAsyncDownload」を参照してください。

  • bstrURL
    [入力] データの入手先となる URL です。有効な URL またはファイル名になります。NULL は指定できません。次に例を示します。

    CComBSTR mybstr =_T("http://somesite/data.htm")

  • pUnkContainer
    [入力] コンテナの IUnknown です。既定値は、NULL です。

  • bRelative
    [入力] URL が相対的か絶対的かを示すフラグです。既定値は FALSE で、URL は絶対的な意味を持ちます。

戻り値

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

解説

データは、有効になるごとに OnDataAvailable を介してオブジェクトに送られます。OnDataAvailable は、データを読み取り、pFunc が指す関数を呼び出します。たとえば、データを保存する関数やデータを画面に表示する関数などを呼び出します。

必要条件

ヘッダー : atlctl.h

参照

参照

CBindStatusCallback クラス

CBindStatusCallback::StartAsyncDownload

その他の技術情報

CBindStatusCallback のメンバ