BITS_JOB_PROPERTY_ID列挙 (bits5_0.h)

  • [アーティクル]

BITS ジョブの プロパティの ID を指定する定数を定義します。

この列挙体は、共用体に含まれる値の型を決定するために、 BITS_JOB_PROPERTY_VALUE 共用体で使用されます。

構文

typedef enum BITS_JOB_PROPERTY_ID {
  BITS_JOB_PROPERTY_ID_COST_FLAGS = 1,
  BITS_JOB_PROPERTY_NOTIFICATION_CLSID = 2,
  BITS_JOB_PROPERTY_DYNAMIC_CONTENT = 3,
  BITS_JOB_PROPERTY_HIGH_PERFORMANCE = 4,
  BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE = 5,
  BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS = 7,
  BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS = 9,
  BITS_JOB_PROPERTY_ON_DEMAND_MODE = 10
} ;

定数

 
BITS_JOB_PROPERTY_ID_COST_FLAGS
値: 1
携帯ネットワークや同様のネットワークでの 転送動作を制御 するために使用される ID。 このプロパティは、転送の進行中に変更される可能性があります。新しいコスト フラグはすぐに有効になります。

このプロパティは、 BITS_JOB_PROPERTY_VALUEの DWORD フィールドを使用します。
BITS_JOB_PROPERTY_NOTIFICATION_CLSID
値: 2
BITS ジョブの進行状況と完了に関する通知を受け取るために CLSID によって COM コールバックを登録 するために使用される ID。 CLSID は、登録されたアウトプロセス COM サーバーに関連付けられているクラスを参照する必要があります。 また、以前に設定した通知 CLSID をクリアするために、 GUID_NULL に設定することもできます。

このプロパティは、 BITS_JOB_PROPERTY_VALUEの CLsID フィールドを使用します。
BITS_JOB_PROPERTY_DYNAMIC_CONTENT
値: 3
BITS ジョブを、BITS ダウンロードの通常の HTTP 要件 (HEAD要求、Content-Length ヘッダー、および Content-Range ヘッダー) をサポートしていないコンテンツをダウンロードする意思としてマークするための ID。 BITS はサポートなしでダウンロード ジョブを一時停止および再開できないため、この種類のコンテンツのダウンロードはオプトインされます。 ネットワーク接続の一時的な損失やシステムの再起動など、何らかの理由でこのプロパティが有効になっているジョブが中断された場合、BITS は中断した場所を再開するのではなく、最初からダウンロードを再開します。 BITS では、動的ダウンロードの帯域幅の使用を調整することもできません。BITS では、 BG_JOB_PRIORITY_FOREGROUND 割り当てられていないジョブに対して、非rottled 転送は実行されないため、通常、動的コンテンツを許可するようにジョブを設定するを使用するたびに、その優先順位を設定する必要があります。

このプロパティは、 BITS_JOB_PROPERTY_VALUEの [有効] フィールドを使用します。 このプロパティは、 BG_JOB_TYPE_DOWNLOAD ジョブでのみサポートされます。 FILE_RANGESを使用するダウンロードではサポートされていません。 このプロパティは、ジョブで Resume が初めて呼び出される前にのみ設定できます。
BITS_JOB_PROPERTY_HIGH_PERFORMANCE
値: 4
BITS ジョブを強力な信頼性保証を必要としないものとしてマークするための ID。 このプロパティを有効にすると、BITS は通常は定期的に行われる通常のジョブの進行状況に関する情報の保持を回避します。 転送中に電源損失などの予期しないシャットダウンが発生した場合、BITS の進行状況が失われます

通常どおり中断した場所から再開するのではなく、最初からジョブを再起動します。 ただし、ジョブの有効期間中に BITS が行うディスク書き込みの数も減り、小さなジョブのパフォーマンスを向上させることができます。

また、このプロパティを使用すると、BITS は一時ファイルにダウンロードされ、転送が完了したら一時ファイルを最終的な宛先に移動する代わりに、宛先ファイルに直接ダウンロードされます。 つまり、ジョブが取り消された場合、または致命的なエラー状態が発生した場合、BITS は部分的にダウンロードされたコンテンツをクリーンしません。作成された場合、BITS 呼び出し元は宛先ファイルをクリーンアップします。 ただし、ディスクのオーバーヘッドも若干軽減されます。

このプロパティは、多数の小さなジョブ (1 MB 以下) が関係し、電力損失やその他の予期しないシャットダウン イベントに信頼性を必要としないシナリオにのみ推奨されます。 パフォーマンスの節約は、通常、少数のジョブや大きなジョブでは重要ではありません。

このプロパティは、 BITS_JOB_PROPERTY_VALUEの [有効] フィールドを使用します。 このプロパティは、 BG_JOB_TYPE_DOWNLOAD ジョブでのみサポートされます。 このプロパティは、ジョブにファイルを追加する前にのみ設定できます。
BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE
値: 5
BITS ジョブの最大バイト数をマークするための ID は、合計でダウンロードできます。 このプロパティは 、ダウンロードするファイルのサイズを事前に判断できない可能性がありますが、可能な合計ダウンロード サイズを上限とするBITS_JOB_PROPERTY_DYNAMIC_CONTENTで使用することを目的としています。

このプロパティは、 BITS_JOB_PROPERTY_VALUEの [有効] フィールドを使用します。 このプロパティは、 BG_JOB_TYPE_DOWNLOAD ジョブでのみサポートされます。 このプロパティは、ジョブで Resume が初めて呼び出される前にのみ設定できます。
BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS
値: 7
BITS ジョブをプロキシ サーバーへの要求に既定の資格情報を含める意思があるものとしてマークするための ID。 このプロパティを有効にすることは、BITS がユーザーに代わって行う要求に対して WinHTTP セキュリティ レベル の WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM を設定することと同じです。 ユーザー BITS は、 から格納された資格情報を取得します。これは、ネットワーク要求の代わりに行う資格情報と同じです。BITS は、ネットワーク ヘルパー トークンを明示的に指定していない限り、通常はジョブ所有者の資格情報を使用します。その場合、BITS はネットワーク ヘルパー トークンの資格情報を使用します。

このプロパティは、 BITS_JOB_PROPERTY_VALUEの Target フィールドを使用します。 ただし、 BG_AUTH_TARGET_PROXY ターゲットのみがサポートされています。
BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS
値: 9
BITS JobNotification 通知と FileRangesTransferred 通知のタイミングを制御するために使用される ID。 このプロパティを有効にすると、ユーザーは別のレートで通知を受け取ります。 このプロパティは、転送中に変更される場合があります。ただし、新しいレートはすぐに適用されない場合があります。 既定値は 500 ミリ秒です。

このプロパティは、 BITS_JOB_PROPERTY_VALUEの DWORD フィールドを使用します。
BITS_JOB_PROPERTY_ON_DEMAND_MODE
値: 10
ジョブがオンデマンド モードであるかどうかを制御するために使用される ID。 オンデマンド ジョブを使用すると、アプリは最初から最後までダウンロードするのではなく、ファイルダウンロードの特定の範囲を要求できます。 既定値は FALSE です。ジョブはオンデマンドではありません。 範囲は、 IBackgroundCopyFile6::RequestFileRanges メソッドを 使用して要求されます。

このプロパティは、 BITS_JOB_PROPERTY_VALUEの [有効] フィールドを使用します。

BITS_JOB_PROPERTY_ON_DEMAND_MODE ジョブの要件は、転送がBG_JOB_TYPE_DOWNLOAD ジョブである必要があるということです。 ジョブを DYNAMIC にすることはできません。また、サーバーは HTTP または HTTPS サーバーである必要があり、範囲サポートのサーバー要件がすべて満たされている必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 8
サポートされている最小のサーバー Windows Server 2012
Header bits5_0.h

こちらもご覧ください