структура HTTP_SSL_CLIENT_CERT_INFO (http.h)

Статья
08/24/2023

Структура HTTP_SSL_CLIENT_CERT_INFO содержит данные о ssl-сертификате клиента, который можно использовать для определения допустимости сертификата.

Синтаксис

typedef struct _HTTP_SSL_CLIENT_CERT_INFO {
  ULONG   CertFlags;
  ULONG   CertEncodedSize;
  PUCHAR  pCertEncoded;
  HANDLE  Token;
  BOOLEAN CertDeniedByMapper;
} HTTP_SSL_CLIENT_CERT_INFO, *PHTTP_SSL_CLIENT_CERT_INFO;

Члены

CertFlags

Флаги, указывающие, действителен ли сертификат. Возможные значения для этого элемента — это код состояния SSPI , возвращаемый из SSPI, или один из следующих флагов из элемента dwErrorструктуры CERT_CHAIN_POLICY_STATUS :

CERT_E_EXPIRED

CERT_E_UNTRUSTEDCA

CERT_E_WRONG_USAGE

CERT_E_UNTRUSTEDROOT

CERT_E_REVOKED

CERT_E_CN_NO_MATCH

CertEncodedSize

Размер сертификата в байтах.

pCertEncoded

Указатель на фактический сертификат.

Token

Дескриптор маркера доступа. Если флаг HTTP_SERVICE_CONFIG_SSL_FLAG_USE_DS_MAPPER установлен с помощью функции HttpSetServiceConfiguration и сертификат клиента успешно сопоставлен с учетной записью пользователя операционной системы, то этот элемент содержит дескриптор допустимого маркера доступа. Если структура HTTP_SSL_CLIENT_CERT_INFO больше не требуется, отпустите этот маркер явным образом, закрыв дескриптор.

CertDeniedByMapper

Зарезервировано.

На структуру HTTP_SSL_CLIENT_CERT_INFO указывает элемент pClientCertInfoструктуры HTTP_SSL_INFO и используется функцией HttpReceiveClientCertificate для возврата данных о сертификате клиента с помощью параметра pSslClientCertInfo .

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	http.h

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

Структуры API HTTP-сервера версии 1.0

HTTP_SSL_INFO

HttpReceiveClientCertificate

Поделиться через