IBitsPeerCacheAdministration::SetConfigurationFlags メソッド (bits3_0.h)

  • [アーティクル]

コンピューターがコンテンツをピアに提供し、ピアからコンテンツをダウンロードできるかどうかを決定する構成フラグを設定します。

構文

HRESULT SetConfigurationFlags(
  [in] DWORD Flags
);

パラメーター

[in] Flags

コンピューターがピアにコンテンツを提供し、ピアからコンテンツをダウンロードできるかどうかを決定するフラグ。 次のフラグを設定できます。

値 意味
BG_ENABLE_PEERCACHING_CLIENT
0x0001
 コンピューターは、ピアからコンテンツをダウンロードできます。

BITS は、クライアント コンピューターとジョブの両方で BITS がピアからファイルをダウンロードすることを許可しない限り、ピアからファイルをダウンロードしません。 ジョブがピアからファイルをダウンロードできるようにするには、 IBackgroundCopyJob4::SetPeerCachingFlags メソッドを 呼び出し、BG_JOB_ENABLE_PEERCACHING_CLIENT フラグを設定します。

この値を変更すると、コンピューター上のすべてのジョブに影響する可能性があることに注意してください。 次のいずれかの条件が存在する場合、BITS はダウンロードを停止し、ジョブとキャッシュの値に応じて、ピアまたは配信元サーバーからの転送を開始するようにジョブを再スケジュールします。

  • キャッシュのこの値は TRUE で、ジョブの値は TRUE と FALSE の間で切り替わります。
  • ジョブ プロパティのこの値は TRUE で、キャッシュの値は TRUE と FALSE の間で切り替わります。
その後、BITS がジョブを停止する前に、ダウンロードが中断された場所から再開されます。
BG_ENABLE_PEERCACHING_SERVER
0x0002
 コンピューターは、コンテンツをピアに提供できます。

BITS は、クライアント コンピューターとジョブの両方で BITS がファイルのキャッシュと提供を許可しない限り、ファイルをキャッシュしてピアに提供しません。 ジョブがジョブのファイルをキャッシュできるようにするには、 IBackgroundCopyJob4::SetPeerCachingFlags メソッドを 呼び出し、BG_JOB_ENABLE_PEERCACHING_SERVER フラグを設定します。

戻り値

メソッドは、次の戻り値を返します。

リターン コード 説明
S_OK
 Success
BG_S_OVERRIDDEN_BY_POLICY
 構成設定は正常に保存されましたが、構成されたグループ ポリシー設定によって設定が優先されるため、この設定は使用されません。

値セットがグループ ポリシー値と異なる場合、メソッドはこの値を返します。 値が同じ場合、メソッドは S_OKを返します。

注釈

この値は、EnablePeerCaching グループ ポリシーが設定されていない場合にのみ使用されます。

ジョブは、ピアからコンテンツをダウンロードするか、そのコンテンツをピアに提供するかを決定します。 詳細については、 IBackgroundCopyJob4::SetPeerCachingFlags メソッドを 参照してください。

要件

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

こちらもご覧ください

IBackgroundCopyJob4::SetPeerCachingFlags

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration::GetConfigurationFlags