win (WINHTTP_CERTIFICATE_INFO结构http.h)

  • 项目

WINHTTP_CERTIFICATE_INFO 结构包含从服务器返回的证书信息。 WinHttpQueryOption 函数使用此结构。

语法

typedef struct _WINHTTP_CERTIFICATE_INFO {
  FILETIME ftExpiry;
  FILETIME ftStart;
  LPWSTR   lpszSubjectInfo;
  LPWSTR   lpszIssuerInfo;
  LPWSTR   lpszProtocolName;
  LPWSTR   lpszSignatureAlgName;
  LPWSTR   lpszEncryptionAlgName;
  DWORD    dwKeySize;
} WINHTTP_CERTIFICATE_INFO, *PWINHTTP_CERTIFICATE_INFO;

成员

ftExpiry

包含证书过期日期的 FILETIME 结构。

ftStart

包含证书生效日期的 FILETIME 结构。

lpszSubjectInfo

指向缓冲区的指针，该缓冲区包含为其颁发证书的组织、站点和服务器的名称。

lpszIssuerInfo

指向缓冲区的指针，该缓冲区包含颁发证书的组织、站点和服务器的名称。

lpszProtocolName

指向缓冲区的指针，该缓冲区包含用于提供安全连接的协议的名称。 当前未使用此成员。

lpszSignatureAlgName

指向缓冲区的指针，该缓冲区包含用于对证书进行签名的算法的名称。 当前未使用此成员。

lpszEncryptionAlgName

指向缓冲区的指针，该缓冲区包含用于通过安全通道 (SSL/TLS) 连接执行加密的算法的名称。 当前未使用此成员。

dwKeySize

密钥的大小（以字节为单位）。

注解

WINHTTP_CERTIFICATE_INFO结构包含有关连接使用 SSL/TLS 时服务器返回的证书的信息。 当传递给 WinHttpQueryOption 函数的 dwOption 参数设置为 WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT 时，WinHttpQueryOption 函数返回WINHTTP_CERTIFICATE_INFO结构。 有关详细信息，请参阅 选项标志。

WinHttpQueryOption 函数不设置 WINHTTP_CERTIFICATE_INFO 结构的 lpszProtocolName、lpszSignatureAlgName 和 lpszEncryptionAlgName 成员，因此这些成员始终返回 NULL。

应用程序不再需要返回 的 WINHTTP_CERTIFICATE_INFO 结构后，应调用 LocalFree 函数以释放结构中返回的任何指针。 包含非 NULL 且需要释放的指针的结构成员是 lpszSubjectInfo 和 lpszIssuerInfo。

注意对于 Windows XP 和 Windows 2000，请参阅 Windows HTTP 服务起始页的运行时要求部分。
 

要求

要求 值
最低受支持的客户端 Windows XP、Windows 2000 Professional 和 SP3 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003、Windows 2000 Server SP3 [仅限桌面应用]
标头 winhttp.h
可再发行组件 Windows XP 和 Windows 2000 上的 WinHTTP 5.0 和 Internet Explorer 5.01 或更高版本。

另请参阅

选项标志

WinHTTP 版本

WinHttpQueryOption