IBackgroundCopyJob4::SetPeerCachingFlags メソッド (bits3_0.h)

  • [アーティクル]

ジョブのファイルをキャッシュしてピアに提供できるかどうか、およびジョブがピアからコンテンツをダウンロードできるかどうかを決定するフラグを設定します。

構文

HRESULT SetPeerCachingFlags(
  [in] DWORD Flags
);

パラメーター

[in] Flags

ジョブのファイルをキャッシュしてピアに提供できるかどうかを決定するフラグと、ジョブがピアからコンテンツをダウンロードできるかどうかを判断するフラグ。 次のフラグを設定できます。

値 意味
BG_JOB_ENABLE_PEERCACHING_CLIENT
0x0001
 ジョブは、ピアからコンテンツをダウンロードできます。

クライアント コンピューターとジョブの両方でバックグラウンド インテリジェント転送サービス (BITS) がピアからファイルをダウンロードできない限り、ジョブはピアからダウンロードされません。 クライアント コンピューターがピアからファイルをダウンロードできるようにするには、 EnablePeerCaching グループ ポリシーを設定するか、 IBitsPeerCacheAdministration::SetConfigurationFlags メソッドを呼び出して、BG_ENABLE_PEERCACHING_CLIENT フラグを設定します。

次のいずれかの条件が存在する場合、BITS はダウンロードを停止し、ジョブとキャッシュの値に応じて、ピアサーバーまたは配信元サーバーからの転送を開始するようにジョブを再スケジュールします。

  • キャッシュのこの値は TRUE で、ジョブの値は TRUE と FALSE の間で切り替わります。
  • ジョブ プロパティのこの値は TRUE で、キャッシュの値は TRUE と FALSE の間で切り替わります。
その後、BITS がジョブを停止する前に、ダウンロードが中断された場所から再開されます。BITS 4.0: このフラグは非推奨です。
BG_JOB_ENABLE_PEERCACHING_SERVER
0x0002
 ジョブのファイルをキャッシュし、ピアに提供できます。

BITS は、クライアント コンピューターとジョブの両方で BITS がファイルのキャッシュと提供を許可しない限り、ファイルをキャッシュしてピアに提供しません。 BITS がクライアント コンピューター上のファイルをキャッシュして処理できるようにするには、 EnablePeerCaching グループ ポリシーを設定するか、 IBitsPeerCacheAdministration::SetConfigurationFlags メソッドを呼び出して、BG_ENABLE_PEERCACHING_SERVER フラグを設定します。BITS 4.0: このフラグは非推奨です。
BG_JOB_DISABLE_BRANCH_CACHE
0x0004
 BITS では、転送ジョブに Windows BranchCache は使用されません。 この設定は、BITS 以外のアプリケーションによる Windows BranchCache の使用には影響しません。

戻り値

このメソッドは次の値を返します。

リターン コード 説明
S_OK
 Success

注釈

これらのフラグの設定は、 EnablePeerCaching グループ ポリシーを設定するか、 IBitsPeerCacheAdministration::SetConfigurationFlags を呼び出すことによってピア キャッシュが有効になっている場合にのみ意味します。

要件

要件 値
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー bits3_0.h (Bits.h を含む)
Library Bits.lib

こちらもご覧ください

IBackgroundCopyJob4

IBackgroundCopyJob4::GetPeerCachingFlags

IBitsPeerCacheAdministration::SetConfigurationFlags