BG_JOB_STATE列挙 (bits.h)

ジョブのさまざまな状態を指定する定数を定義します。

構文

typedef enum BG_JOB_STATE {
  BG_JOB_STATE_QUEUED = 0,
  BG_JOB_STATE_CONNECTING,
  BG_JOB_STATE_TRANSFERRING,
  BG_JOB_STATE_SUSPENDED,
  BG_JOB_STATE_ERROR,
  BG_JOB_STATE_TRANSIENT_ERROR,
  BG_JOB_STATE_TRANSFERRED,
  BG_JOB_STATE_ACKNOWLEDGED,
  BG_JOB_STATE_CANCELLED
} ;

定数

 
BG_JOB_STATE_QUEUED
値: 0
ジョブがキュー内にあり、実行を待機していることを指定します。 ジョブの転送中にユーザーがログオフすると、ジョブはキューに登録された状態に遷移します。
BG_JOB_STATE_CONNECTING
BITS がサーバーに接続しようとしていることを指定します。 接続が成功すると、ジョブの状態が BG_JOB_STATE_TRANSFERRINGになります。それ以外の場合、状態は BG_JOB_STATE_TRANSIENT_ERRORになります。
BG_JOB_STATE_TRANSFERRING
BITS がジョブのデータを転送することを指定します。
BG_JOB_STATE_SUSPENDED
ジョブが中断 (一時停止) されることを指定します。 ジョブを中断するには、 IBackgroundCopyJob::Suspend メソッドを呼び出します。 BITS は、ジョブの作成時にジョブを自動的に中断します。 IBackgroundCopyJob::Resume メソッド、IBackgroundCopyJob::Complete メソッド、または IBackgroundCopyJob::Cancel メソッドを呼び出すまで、ジョブは中断されたままになります。
BG_JOB_STATE_ERROR
回復不可能なエラーが発生したことを指定します (サービスはファイルを転送できません)。 アクセス拒否エラーなどのエラーを修正できる場合は、 を呼び出します。
IBackgroundCopyJob::Resume メソッド エラーが修正された後。 ただし、エラーを修正できない場合は、 を呼び出します。
IBackgroundCopyJob::Cancel メソッド ジョブを取り消すか、 を呼び出します。
IBackgroundCopyJob::Complete メソッド を使用して、正常に転送されたダウンロード ジョブの一部を受け入れます。
BG_JOB_STATE_TRANSIENT_ERROR
回復可能なエラーが発生したことを指定します。 BITS は、指定した再試行間隔に基づいて、一時的なエラー状態のジョブを再試行します ( 「IBackgroundCopyJob::SetMinimumRetryDelay メソッド」を参照)。 ジョブが進行に失敗した場合、ジョブの状態は BG_JOB_STATE_ERROR に変わります ( 「IBackgroundCopyJob::SetNoProgressTimeout メソッド」を参照)。

ネットワーク切断またはディスク ロック エラーが発生した場合 (実行中など)、MaxInternetBandwidth グループ ポリシーが 0 の場合、 chkdsk BITS はジョブを再試行しません。
BG_JOB_STATE_TRANSFERRED
ジョブが正常に処理されたことを指定します。 を呼び出す必要があります。
IBackgroundCopyJob::Complete メソッド を使用して、ジョブの完了を確認し、ファイルをクライアントで使用できるようにします。
BG_JOB_STATE_ACKNOWLEDGED
ジョブが正常に完了したことを確認するために IBackgroundCopyJob::Complete メソッド を呼び出したことを指定します。
BG_JOB_STATE_CANCELLED
を呼び出したことを指定します。
IBackgroundCopyJob::Cancel メソッド ジョブを取り消す場合 (つまり、転送キューからジョブを削除する場合)。

要件

要件
サポートされている最小のクライアント Windows XP
サポートされている最小のサーバー Windows Server 2003
Header bits.h

こちらもご覧ください