HTTP_SERVICE_CONFIG_SSL_SNI_QUERY-Struktur (http.h)

Die HTTP_SERVICE_CONFIG_SSL_SNI_QUERY-Struktur wird verwendet, um einen bestimmten SSL-Zertifikatdatensatz (Secure Sockets Layer) server name indication (SNI) anzugeben, der im SSL-SNI-Speicher abfragt. Sie wird mithilfe des pInputConfigInfo-Parameters an die HttpQueryServiceConfiguration-Funktion übergeben, wenn der ConfigId-Parameter auf HttpServiceConfigSslSniCertInfo festgelegt ist.

Syntax

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

Einer der folgenden Werte aus der HTTP_SERVICE_CONFIG_QUERY_TYPE-Enumeration .

Wert	Bedeutung
HttpServiceConfigQueryExact	Gibt einen einzelnen SSL-SNI-Zertifikatdatensatz zurück.
HttpServiceConfigQueryNext	Gibt eine Sequenz von SSL-SNI-Zertifikateinträgen in einer Sequenz von Aufrufen zurück, die von dwToken gesteuert wird.

KeyDesc

Wenn der QueryDesc-Parameter gleich HttpServiceConfigQueryExact ist, sollte KeyDesc eine HTTP_SERVICE_CONFIG_SSL_SNI_KEY Struktur enthalten, die den abgefragten SSL-SNI-Zertifikatdatensatz identifiziert. Wenn der QueryDesc-Parameter gleich HTTPServiceConfigQueryNext ist, wird KeyDesc ignoriert.

dwToken

Wenn der QueryDesc-Parameter gleich HTTPServiceConfigQueryNext ist, muss dwToken beim ersten Aufruf der HttpQueryServiceConfiguration-Funktion gleich 0 sein, einer für den zweiten Aufruf, zwei beim dritten Aufruf und so weiter, bis alle SSL-Zertifikatdatensätze zurückgegeben werden. HttpQueryServiceConfiguration gibt ERROR_NO_MORE_ITEMS zurück.

Wenn der QueryDesc-Parameter gleich HttpServiceConfigQueryExact ist, wird dwToken ignoriert.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Kopfzeile	http.h

Weitere Informationen

HTTP_SERVICE_CONFIG_SSL_SNI_KEY

HTTP_SERVICE_CONFIG_SSL_SNI_SET

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpSetServiceConfiguration