IBackgroundCopyJobHttpOptions::SetSecurityFlags メソッド (bits2_5.h)

証明書失効リストがチェックされ、特定の証明書エラーが無視されるかどうかを決定する HTTP のフラグと、サーバーが HTTP 要求をリダイレクトするときに使用するポリシーを設定します。

構文

HRESULT SetSecurityFlags(
  [in] ULONG Flags
);

パラメーター

[in] Flags

サーバーに接続するときに無視するエラーを示す HTTP セキュリティ フラグ。 次のフラグを 1 つ以上設定できます。

戻り値

次の表に、可能な戻り値の一部を示します。

解説

CRL チェックが要求された場合、BITS は、HTTPS プロトコルを指定するジョブ内のすべてのファイルに対してチェックを実行します。 チェックは、ファイルの転送を開始する前に、各ファイルに対して行われます。 BITS がファイルを部分的にダウンロードした後にこの値を TRUE に 設定すると、BITS によってジョブが再スケジュールされ、ファイルのダウンロードが再度開始されます。 既にダウンロードされているファイルは影響を受けません。

CRL が最新の場合、BITS はローカル コンピューター上の CRL を使用します。それ以外の場合、BITS は証明書に署名した証明機関 (CA) から CRL をダウンロードします。

次のエラーが発生した場合、ジョブは致命的なエラー状態になります。

リダイレクト ポリシーは、ダウンロード ジョブ内のすべてのファイルに適用されます (ポリシーはアップロード ジョブには適用されません)。

BITS 3.0 より前: リダイレクト ポリシーはサポートされていません。

ポリシーがBG_HTTP_REDIRECT_POLICY_DISALLOWされ、サーバーが要求をリダイレクトすると、ジョブは致命的なエラー状態になり、次のいずれかのエラー コードが表示されます。 エラー コードの説明については、「 HTTP 状態コード」を参照してください。

• HRESULT_FROM_WIN32(HTTP_STATUS_AMBIGUOUS)
• HRESULT_FROM_WIN32(HTTP_STATUS_MOVED)
• HRESULT_FROM_WIN32(HTTP_STATUS_REDIRECT)
• HRESULT_FROM_WIN32(HTTP_STATUS_REDIRECT_METHOD)
• HRESULT_FROM_WIN32(HTTP_STATUS_REDIRECT_KEEP_VERB)

ピア キャッシュが有効で、BG_HTTP_REDIRECT_POLICY_ALLOW_REPORTを指定した場合、ファイルは最終的にリダイレクトされた URL でキャッシュに格納されます。 その後、ピアが元の URL でファイルをダウンロードしようとすると、ピアはピアのキャッシュ内のファイルを見つけず、配信元サーバーからファイルをダウンロードすることになります。

を指定し、ファイルが からダウンロードされる場合は、

BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT設定は、 IBackgroundCopyJob3::ReplaceRemotePrefix メソッドを呼び出すときに結果に影響する可能性があることに注意してください。 サーバーが要求をリダイレクトした場合、BITS は既に元の URL を最終リダイレクト URL に変更しているため、 ReplaceRemotePrefix メソッドを呼び出しても元の URL を持つファイルは見つかりません。

要件

関連項目

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::GetSecurityFlags