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

  • [アーティクル]

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

構文

HRESULT GetSecurityFlags(
  [out] ULONG *pFlags
);

パラメーター

[out] pFlags

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

値 意味
BG_SSL_ENABLE_CRL_CHECK
0x0001
 証明書失効リスト (CRL) を確認して、サーバー証明書が取り消されていないことを確認します。
BG_SSL_IGNORE_CERT_CN_INVALID
0x0002
 サーバーの証明書ホスト名が要求のホスト名と一致しない場合に発生するエラーを無視します。
BG_SSL_IGNORE_CERT_DATE_INVALID
0x0004
 有効期限が切れた証明書によって発生したエラーを無視します。
BG_SSL_IGNORE_UNKNOWN_CA
0x0008
 不明な証明機関 (CA) に関連付けられているエラーを無視します。
BG_SSL_IGNORE_CERT_WRONG_USAGE
0x0010
 証明書の使用に関連するエラーを無視します。
BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT
0x0000
 サーバーが要求を別のサーバーにリダイレクトできるようにします。 既定値です。
BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT
0x0100
 サーバーが要求を別のサーバーにリダイレクトできるようにします。 BITS は、最後の URL でリモート名を更新します。
BG_HTTP_REDIRECT_POLICY_DISALLOW
0x0200
 サーバーが要求を別のサーバーにリダイレクトするときに、ジョブを致命的なエラー状態にPlacesします。 BITS は、リダイレクトされた URL を使用してリモート名を更新します。
BG_HTTP_REDIRECT_POLICY_MASK
0x0700
 セキュリティ フラグ値と共に使用して、有効なリダイレクト ポリシーを決定できるビットマスク。 フラグ ALLOW_HTTPS_TO_HTTPは含まれません。

次の例は、このマスクを使用して、BG_HTTP_REDIRECT_POLICY_DISALLOW リダイレクト ポリシーをテストする方法を示しています。

if (BG_HTTP_REDIRECT_POLICY_DISALLOW == (flags & BG_HTTP_REDIRECT_POLICY_MASK))
BG_HTTP_REDIRECT_POLICY_ALLOW_HTTPS_TO_HTTP
0x0800
 サーバーが HTTPS 要求を HTTP URL にリダイレクトできるようにします。

このフラグは、BG_HTTP_REDIRECT_POLICY_ALLOW_SILENTとBG_HTTP_REDIRECT_POLICY_ALLOW_REPORTと組み合わせることができます。

戻り値

成功した場合S_OKを返します。

要件

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

こちらもご覧ください

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::SetSecurityFlags