Share via

структура WINHTTP_CERTIFICATE_INFO (winhttp.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 возвращает структуру WINHTTP_CERTIFICATE_INFO , если параметр dwOption , передаваемый в функцию WinHttpQueryOption , имеет значение WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT. Дополнительные сведения см. в разделе Флаги параметров.

Функция WinHttpQueryOption не задает элементы lpszProtocolName, lpszSignatureAlgName и lpszEncryptionAlgNameструктуры WINHTTP_CERTIFICATE_INFO , поэтому эти элементы всегда возвращаются как NULL.

Когда приложению больше не требуется возвращаемая WINHTTP_CERTIFICATE_INFO структура, следует вызвать функцию LocalFree , чтобы освободить все указатели, возвращаемые в структуре. Элементы структуры, содержащие указатели, которые не имеют значения NULL и должны быть освобождены, — это lpszSubjectInfo и lpszIssuerInfo.

Примечание Для Windows XP и Windows 2000 см. раздел Требования к времени выполнения на начальной странице служб WINDOWS HTTP .
 

Требования

Требование Значение
Минимальная версия клиента Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения]
Верхняя часть winhttp.h
Распространяемые компоненты WinHTTP 5.0 и Internet Обозреватель 5.01 или более поздней версии в Windows XP и Windows 2000.

См. также раздел

Флаги параметров

Версии WinHTTP

WinHttpQueryOption