struttura HTTP_SERVICE_CONFIG_SSL_SNI_QUERY (http.h)

Articolo
08/24/2023

La struttura HTTP_SERVICE_CONFIG_SSL_SNI_QUERY viene usata per specificare un determinato record di certificato SSL (Secure Sockets Layer) Nome server (SNI) da eseguire query nell'archivio SNI SSL. Viene passato alla funzione HttpQueryServiceConfiguration usando il parametro pInputConfigInfo quando il parametro ConfigId è impostato su HttpServiceConfigSslSniCertInfo.

Sintassi

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;

Members

QueryDesc

Uno dei valori seguenti dell'enumerazione HTTP_SERVICE_CONFIG_QUERY_TYPE .

Valore	Significato
HttpServiceConfigQueryExact	Restituisce un singolo record di certificato SNI SSL.
HttpServiceConfigQueryNext	Restituisce una sequenza di record di certificato SNI SSL in una sequenza di chiamate, come controllato da dwToken.

KeyDesc

Se il parametro QueryDesc è uguale a HttpServiceConfigQueryExact, KeyDesc deve contenere una struttura HTTP_SERVICE_CONFIG_SSL_SNI_KEY che identifica il record di certificato SNI SSL sottoposto a query. Se il parametro QueryDesc è uguale a HTTPServiceConfigQueryNext, KeyDesc viene ignorato.

dwToken

Se il parametro QueryDesc è uguale a HTTPServiceConfigQueryNext, dwToken deve essere uguale a zero nella prima chiamata alla funzione HttpQueryServiceConfiguration , una nella seconda chiamata, due nella terza chiamata e così via finché non vengono restituiti tutti i record di certificato SSL, a quel punto HttpQueryServiceConfiguration restituisce ERROR_NO_MORE_ITEMS.

Se il parametro QueryDesc è uguale a HttpServiceConfigQueryExact, dwToken viene ignorato.