通过

IBackgroundCopyJobHttpOptions：：GetSecurityFlags 方法 (bits2_5.h)

  • 项目

检索 HTTP 的标志，这些标志确定是否检查证书吊销列表并忽略某些证书错误，以及服务器重定向 HTTP 请求时要使用的策略。

语法

HRESULT GetSecurityFlags(
  [out] ULONG *pFlags
);

参数

[out] pFlags

HTTP 安全标志，指示连接到服务器时要忽略的错误。 可以设置以下一个或多个标志：

值 含义
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