Win32 API 日本語リファレンス
ホームNetworking.BackgroundIntelligentTransferService › BG_JOB_STATE

BG_JOB_STATE

列挙型
基底型i4

メンバー 9

名前10進16進説明
BG_JOB_STATE_QUEUED00x0ジョブがキューに入っており、実行を待機していることを指定します。ジョブの転送中にユーザーがログオフした場合、そのジョブはキュー待ち状態に遷移します。
BG_JOB_STATE_CONNECTING10x1BITS がサーバーへの接続を試みていることを指定します。接続に成功した場合、ジョブの状態は BG_JOB_STATE_TRANSFERRING になります。それ以外の場合は BG_JOB_STATE_TRANSIENT_ERROR になります。
BG_JOB_STATE_TRANSFERRING20x2BITS がジョブのデータを転送していることを指定します。
BG_JOB_STATE_SUSPENDED30x3ジョブが中断 (一時停止) されていることを指定します。ジョブを中断するには、IBackgroundCopyJob::Suspend メソッドを呼び出します。BITS は、ジョブの作成時に自動的にそのジョブを中断します。IBackgroundCopyJob::Resume メソッドIBackgroundCopyJob::Complete メソッド、または IBackgroundCopyJob::Cancel メソッドを呼び出すまで、ジョブは中断されたままです。
BG_JOB_STATE_ERROR40x4回復不能なエラーが発生したことを指定します (サービスがファイルを転送できません)。そのエラー—たとえばアクセス拒否エラー—を修正できる場合は、エラーを解決した後に IBackgroundCopyJob::Resume メソッド を呼び出します。ただし、エラーを修正できない場合は、 IBackgroundCopyJob::Cancel メソッド を呼び出してジョブをキャンセルするか、 IBackgroundCopyJob::Complete メソッド を呼び出して、ダウンロードジョブのうち正常に転送された部分を受け入れます。
BG_JOB_STATE_TRANSIENT_ERROR50x5

回復可能なエラーが発生したことを指定します。BITS は、指定された再試行間隔に基づいて、一時的なエラー状態のジョブを再試行します (IBackgroundCopyJob::SetMinimumRetryDelay メソッド を参照してください)。ジョブが進行しない場合、ジョブの状態は BG_JOB_STATE_ERROR に変わります (IBackgroundCopyJob::SetNoProgressTimeout メソッド を参照してください)。

ネットワークの切断やディスクのロックエラーが発生した場合 (たとえば chkdsk の実行中)、または MaxInternetBandwidth グループポリシーが 0 の場合、BITS はジョブを再試行しません。

BG_JOB_STATE_TRANSFERRED60x6ジョブが正常に処理されたことを指定します。ジョブの完了を確認し、ファイルをクライアントから利用できるようにするには、 IBackgroundCopyJob::Complete メソッド を呼び出す必要があります。
BG_JOB_STATE_ACKNOWLEDGED70x7ジョブが正常に完了したことを確認するために、IBackgroundCopyJob::Complete メソッド を呼び出したことを指定します。
BG_JOB_STATE_CANCELLED80x8ジョブをキャンセルする (つまり、転送キューからジョブを削除する) ために、 IBackgroundCopyJob::Cancel メソッド を呼び出したことを指定します。

公式ドキュメント

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum BG_JOB_STATE : int {
    BG_JOB_STATE_QUEUED = 0,
    BG_JOB_STATE_CONNECTING = 1,
    BG_JOB_STATE_TRANSFERRING = 2,
    BG_JOB_STATE_SUSPENDED = 3,
    BG_JOB_STATE_ERROR = 4,
    BG_JOB_STATE_TRANSIENT_ERROR = 5,
    BG_JOB_STATE_TRANSFERRED = 6,
    BG_JOB_STATE_ACKNOWLEDGED = 7,
    BG_JOB_STATE_CANCELLED = 8
} BG_JOB_STATE;
public enum BG_JOB_STATE : int
{
    BG_JOB_STATE_QUEUED = 0,
    BG_JOB_STATE_CONNECTING = 1,
    BG_JOB_STATE_TRANSFERRING = 2,
    BG_JOB_STATE_SUSPENDED = 3,
    BG_JOB_STATE_ERROR = 4,
    BG_JOB_STATE_TRANSIENT_ERROR = 5,
    BG_JOB_STATE_TRANSFERRED = 6,
    BG_JOB_STATE_ACKNOWLEDGED = 7,
    BG_JOB_STATE_CANCELLED = 8,
}
Public Enum BG_JOB_STATE As Integer
    BG_JOB_STATE_QUEUED = 0
    BG_JOB_STATE_CONNECTING = 1
    BG_JOB_STATE_TRANSFERRING = 2
    BG_JOB_STATE_SUSPENDED = 3
    BG_JOB_STATE_ERROR = 4
    BG_JOB_STATE_TRANSIENT_ERROR = 5
    BG_JOB_STATE_TRANSFERRED = 6
    BG_JOB_STATE_ACKNOWLEDGED = 7
    BG_JOB_STATE_CANCELLED = 8
End Enum
import enum

class BG_JOB_STATE(enum.IntEnum):
    BG_JOB_STATE_QUEUED = 0
    BG_JOB_STATE_CONNECTING = 1
    BG_JOB_STATE_TRANSFERRING = 2
    BG_JOB_STATE_SUSPENDED = 3
    BG_JOB_STATE_ERROR = 4
    BG_JOB_STATE_TRANSIENT_ERROR = 5
    BG_JOB_STATE_TRANSFERRED = 6
    BG_JOB_STATE_ACKNOWLEDGED = 7
    BG_JOB_STATE_CANCELLED = 8
// BG_JOB_STATE
pub const BG_JOB_STATE_QUEUED: i32 = 0;
pub const BG_JOB_STATE_CONNECTING: i32 = 1;
pub const BG_JOB_STATE_TRANSFERRING: i32 = 2;
pub const BG_JOB_STATE_SUSPENDED: i32 = 3;
pub const BG_JOB_STATE_ERROR: i32 = 4;
pub const BG_JOB_STATE_TRANSIENT_ERROR: i32 = 5;
pub const BG_JOB_STATE_TRANSFERRED: i32 = 6;
pub const BG_JOB_STATE_ACKNOWLEDGED: i32 = 7;
pub const BG_JOB_STATE_CANCELLED: i32 = 8;
// BG_JOB_STATE
const (
	BG_JOB_STATE_QUEUED int32 = 0
	BG_JOB_STATE_CONNECTING int32 = 1
	BG_JOB_STATE_TRANSFERRING int32 = 2
	BG_JOB_STATE_SUSPENDED int32 = 3
	BG_JOB_STATE_ERROR int32 = 4
	BG_JOB_STATE_TRANSIENT_ERROR int32 = 5
	BG_JOB_STATE_TRANSFERRED int32 = 6
	BG_JOB_STATE_ACKNOWLEDGED int32 = 7
	BG_JOB_STATE_CANCELLED int32 = 8
)
const
  BG_JOB_STATE_QUEUED = 0;
  BG_JOB_STATE_CONNECTING = 1;
  BG_JOB_STATE_TRANSFERRING = 2;
  BG_JOB_STATE_SUSPENDED = 3;
  BG_JOB_STATE_ERROR = 4;
  BG_JOB_STATE_TRANSIENT_ERROR = 5;
  BG_JOB_STATE_TRANSFERRED = 6;
  BG_JOB_STATE_ACKNOWLEDGED = 7;
  BG_JOB_STATE_CANCELLED = 8;
// BG_JOB_STATE
pub const BG_JOB_STATE_QUEUED: i32 = 0;
pub const BG_JOB_STATE_CONNECTING: i32 = 1;
pub const BG_JOB_STATE_TRANSFERRING: i32 = 2;
pub const BG_JOB_STATE_SUSPENDED: i32 = 3;
pub const BG_JOB_STATE_ERROR: i32 = 4;
pub const BG_JOB_STATE_TRANSIENT_ERROR: i32 = 5;
pub const BG_JOB_STATE_TRANSFERRED: i32 = 6;
pub const BG_JOB_STATE_ACKNOWLEDGED: i32 = 7;
pub const BG_JOB_STATE_CANCELLED: i32 = 8;
const
  BG_JOB_STATE_QUEUED* = 0
  BG_JOB_STATE_CONNECTING* = 1
  BG_JOB_STATE_TRANSFERRING* = 2
  BG_JOB_STATE_SUSPENDED* = 3
  BG_JOB_STATE_ERROR* = 4
  BG_JOB_STATE_TRANSIENT_ERROR* = 5
  BG_JOB_STATE_TRANSFERRED* = 6
  BG_JOB_STATE_ACKNOWLEDGED* = 7
  BG_JOB_STATE_CANCELLED* = 8
enum BG_JOB_STATE : int {
    BG_JOB_STATE_QUEUED = 0,
    BG_JOB_STATE_CONNECTING = 1,
    BG_JOB_STATE_TRANSFERRING = 2,
    BG_JOB_STATE_SUSPENDED = 3,
    BG_JOB_STATE_ERROR = 4,
    BG_JOB_STATE_TRANSIENT_ERROR = 5,
    BG_JOB_STATE_TRANSFERRED = 6,
    BG_JOB_STATE_ACKNOWLEDGED = 7,
    BG_JOB_STATE_CANCELLED = 8,
}
#define global BG_JOB_STATE_QUEUED          0x0
#define global BG_JOB_STATE_CONNECTING      0x1
#define global BG_JOB_STATE_TRANSFERRING    0x2
#define global BG_JOB_STATE_SUSPENDED       0x3
#define global BG_JOB_STATE_ERROR           0x4
#define global BG_JOB_STATE_TRANSIENT_ERROR 0x5
#define global BG_JOB_STATE_TRANSFERRED     0x6
#define global BG_JOB_STATE_ACKNOWLEDGED    0x7
#define global BG_JOB_STATE_CANCELLED       0x8