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

Статья
08/24/2023

Структура HTTP_SERVICE_CONFIG_SSL_SNI_QUERY используется для указания конкретной записи ssl-сертификата SNI для запроса в хранилище SSL SNI. Он передается в функцию HttpQueryServiceConfiguration с помощью параметра pInputConfigInfo , если для параметра ConfigId задано значение HttpServiceConfigSslSniCertInfo.

Синтаксис

typedef struct _HTTP_SERVICE_CONFIG_SSL_SNI_QUERY {
  HTTP_SERVICE_CONFIG_QUERY_TYPE  QueryDesc;
  HTTP_SERVICE_CONFIG_SSL_SNI_KEY KeyDesc;
  DWORD                           dwToken;
} HTTP_SERVICE_CONFIG_SSL_SNI_QUERY, *PHTTP_SERVICE_CONFIG_SSL_SNI_QUERY;

Члены

QueryDesc

Одно из следующих значений перечисления HTTP_SERVICE_CONFIG_QUERY_TYPE .

Значение	Значение
HttpServiceConfigQueryExact	Возвращает одну запись сертификата SSL SNI.
HttpServiceConfigQueryNext	Возвращает последовательность записей SSL-сертификата SNI в последовательности вызовов, контролируемых dwToken.

KeyDesc

Если параметр QueryDesc равен HttpServiceConfigQueryExact, то KeyDesc должен содержать HTTP_SERVICE_CONFIG_SSL_SNI_KEY структуру, которая идентифицирует запрашиваемую запись SSL-сертификата SNI. Если параметр QueryDesc равен HTTPServiceConfigQueryNext, параметр KeyDesc игнорируется.

dwToken

Если параметр QueryDesc равен HTTPServiceConfigQueryNext, то dwToken должен быть равен нулю при первом вызове функции HttpQueryServiceConfiguration , один при втором вызове, два при третьем вызове и т. д. До тех пор, пока не будут возвращены все записи SSL-сертификата. В этот момент HttpQueryServiceConfiguration возвращает ERROR_NO_MORE_ITEMS.

Если параметр QueryDesc равен HttpServiceConfigQueryExact, dwToken игнорируется.

Требования


Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Верхняя часть	http.h

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

HTTP_SERVICE_CONFIG_SSL_SNI_KEY

HTTP_SERVICE_CONFIG_SSL_SNI_SET

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

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