IBackgroundCopyJob::GetErrorCount メソッド (bits.h)

  • [アーティクル]

BITS がジョブの転送を試行し、エラーが発生した回数を取得します。

構文

HRESULT GetErrorCount(
  [out] ULONG *Errors
);

パラメーター

[out] Errors

BITS がジョブの転送を試みたときに発生したエラーの数。 ジョブがBG_JOB_STATE_TRANSFERRING状態からBG_JOB_STATE_TRANSIENT_ERRORまたはBG_JOB_STATE_ERROR状態に移行すると、カウントが増加します。

戻り値

このメソッドは、成功 した場合にS_OK を返すか、エラー時に標準の COM HRESULT 値のいずれかを返します。

注釈

カウントはリセットされません。 カウントは、ジョブが一時的なエラーまたはエラー状態に移動した回数を正確に反映していない場合があります。 たとえば、BITS では、ネットワーク切断が発生したとき、チェック ディスク プログラムが実行されたとき、または帯域幅ポリシーによってジョブの転送が妨げられたときに、カウントが増加することはありません。

また、BITS は、ジョブが一時的なエラー状態にあり、ジョブが失敗したときにジョブを転送しようとするたびにカウントを増やします。

BITS 1.5 以前: BITS は、一時的なエラー状態のときにジョブの転送を試みるたびにカウントを増やしません。

要件

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

こちらもご覧ください

IBackgroundCopyJob::GetError