HTTP_SERVICE_CONFIG_SSL_QUERY-Struktur (http.h)

Die HTTP_SERVICE_CONFIG_SSL_QUERY-Struktur wird verwendet, um einen bestimmten Datensatz anzugeben, der im SSL-Konfigurationsspeicher abfragt werden soll. Er wird mithilfe des pInputConfigInfo-Parameters an die HttpQueryServiceConfiguration-Funktion übergeben, wenn der ConfigId-Parameter auf HttpServiceConfigSSLCertInfo festgelegt ist.

Syntax

typedef struct _HTTP_SERVICE_CONFIG_SSL_QUERY {
  HTTP_SERVICE_CONFIG_QUERY_TYPE QueryDesc;
  HTTP_SERVICE_CONFIG_SSL_KEY    KeyDesc;
  DWORD                          dwToken;
} HTTP_SERVICE_CONFIG_SSL_QUERY, *PHTTP_SERVICE_CONFIG_SSL_QUERY;

Member

QueryDesc

Einer der folgenden Werte aus der HTTP_SERVICE_CONFIG_QUERY_TYPE-Enumeration .

HttpServiceConfigQueryExact

Gibt einen einzelnen SSL-Eintrag zurück.

HttpServiceConfigQueryWeiter

Gibt eine Sequenz von SSL-Datensätzen in einer Sequenz von Aufrufen zurück, die vom dwToken-Parameter gesteuert wird.

KeyDesc

Wenn der QueryDesc-Parameter gleich HttpServiceConfigQueryExact ist, sollte KeyDesc eine HTTP_SERVICE_CONFIG_SSL_KEY-Struktur enthalten, die den abgefragten SSL-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 beim zweiten Aufruf, zwei beim dritten Aufruf und so weiter, bis alle SSL-Zertifikatdatensätze zurückgegeben werden. An diesem Punkt gibt HttpQueryServiceConfiguration ERROR_NO_MORE_ITEMS zurück.

Wenn der QueryDesc-Parametergleich HttpServiceConfigQueryExact ist, wird dwToken ignoriert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile http.h

Weitere Informationen

HTTP_SERVICE_CONFIG_QUERY_TYPE

HTTP_SERVICE_CONFIG_SSL_SET

HttpQueryServiceConfiguration