XNetworkingSecurityInformation

定义用来为某个特定的 URL 终结点配置 HTTP 堆栈的安全信息。

语法

typedef struct XNetworkingSecurityInformation {
    uint32_t enabledHttpSecurityProtocolFlags;
    size_t thumbprintCount;
    XNetworkingThumbprint* thumbprints;
} XNetworkingSecurityInformation

成员

enabledHttpSecurityProtocolFlags
类型:uint32_t

标志的位掩码,指示 HTTP 请求应为此 URL 终结点限制哪些传输层安全 (TLS) 协议,以及哪些 TLS 协议应通过对 WinHttpSetOption 的调用传递到 WINHTTP_OPTION_SECURE_PROTOCOLS WinHTTP 选项。 它可以是 WINHTTP_FLAG_SECURE_PROTOCOL_TLS1WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_1WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_2WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_3 的任意组合。

thumbprintCount
类型:size_t

thumbprints 字段指向的数组中的指纹数。

指纹
类型:XNetworkingThumbprint*

指纹数组应位于服务器为此 URL 终结点提供的证书链中。

备注

此结构描述配置 HTTP 堆栈时使用的安全信息。 它确定对于特定的 URL终结点,HTTP 请求应该限制哪些 TLS 协议。 可能并非始终有任何指纹。 典型的 Fiddler 用法有一个根指纹。

要求

头文件:XNetworking.h

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XNetworkingQuerySecurityInformationForUrlAsync
XNetworkingQuerySecurityInformationForUrlUtf16Async
XNetworking