BG_JOB_STATE列挙

BG_JOB_STATE列挙は、ジョブのさまざまな状態の定数値を定義します。

構文

typedef enum  { 
  BG_JOB_STATE_QUEUED,
  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;

定数

BG_JOB_STATE_QUEUED

ジョブがキュー内にあり、実行を待機していることを指定します。 ジョブの転送中にユーザーがログオフすると、ジョブはキューに登録された状態に遷移します。

BG_JOB_STATE_CONNECTING

サポートされていません。

BG_JOB_STATE_TRANSFERRING

配信の最適化がジョブのデータを転送することを指定します。

BG_JOB_STATE_SUSPENDED

ジョブが中断 (一時停止) されることを指定します。 ジョブを中断するには、 IBackgroundCopyJob::Suspend メソッドを呼び出します。 IBackgroundCopyJob::Resume、IBackgroundCopyJob::Complete、または IBackgroundCopyJob::Cancel メソッドを呼び出すまで、ジョブは中断されたままになります。

BG_JOB_STATE_ERROR

回復不可能なエラーが発生したことを指定します (サービスはファイルを転送できません)。 アクセス拒否エラーなどのエラーを修正できる場合は、エラーが修正された後に IBackgroundCopyJob::Resume メソッドを呼び出します。 ただし、エラーを修正できない場合は、 IBackgroundCopyJob::Cancel メソッドを呼び出してジョブを取り消すか、 IBackgroundCopyJob::Complete メソッドを呼び出して、正常に転送されたダウンロード ジョブの一部を受け入れます。

BG_JOB_STATE_TRANSIENT_ERROR

回復可能なエラーが発生したことを指定します。 配信の最適化では、内部再試行構成に基づいて、一時的なエラー状態のジョブを再試行します。 ジョブが進行に失敗した場合、ジョブの状態は BG_JOB_STATE_ERROR に変わります ( 「IBackgroundCopyJob::SetNoProgressTimeout」を参照)。

BG_JOB_STATE_TRANSFERRED

ジョブが正常に処理されたことを指定します。 ジョブの完了を確認し、ファイルをクライアントで使用できるようにするには、 IBackgroundCopyJob::Complete メソッドを呼び出す必要があります。

BG_JOB_STATE_ACKNOWLEDGED

ジョブが正常に完了したことを確認するために IBackgroundCopyJob::Complete メソッドを呼び出したことを指定します。

BG_JOB_STATE_CANCELLED

IBackgroundCopyJob::Cancel メソッドを呼び出してジョブを取り消す (転送キューからジョブを削除する) ことを指定します。

必要条件

要件	値
サポートされている最小のクライアント	Windows 10、バージョン 1709 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server バージョン 1709 [デスクトップ アプリのみ]
Header	Deliveryoptimization.h

関連項目

IBackgroundCopyJob::GetState