IBackgroundCopyJob1::GetProgress メソッド (qmgr.h)

  • [アーティクル]

[IBackgroundCopyJob1 は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、 BITS インターフェイスを使用します。

GetProgress メソッドを使用して、ジョブの進行状況を取得します。

構文

HRESULT GetProgress(
  [in]  DWORD dwFlags,
  [out] DWORD *pdwProgress
);

パラメーター

[in] dwFlags

取得する進行状況の種類。 次のいずれかのフラグを指定します。

値 意味
QM_PROGRESS_PERCENT_DONE
 ダウンロードの完了率を返します。
QM_PROGRESS_SIZE_DONE
 ダウンロードしたバイト数を返します。
QM_PROGRESS_TIME_DONE
 サポートされていません。

[out] pdwProgress

ダウンロードの進行状況。 進行状況は、 dwFlags に応じて、ダウンロードされたバイト数またはダウンロードが完了した割合を表します。

戻り値

このメソッドは、次の HRESULT 値と他の値を返します。

リターン コード 説明
S_OK
 ジョブの進行状況が正常に取得されました。
E_NOTIMPL
 dwFlags パラメーターにQM_PROGRESS_TIME_DONEを指定することはできません。

要件

要件 値
サポートされている最小のクライアント Windows XP
サポートされている最小のサーバー Windows Server 2003
対象プラットフォーム Windows
ヘッダー qmgr.h
[DLL] QmgrPrxy.dll

こちらもご覧ください

IBackgroundCopyJob1