structure HTTP_SERVICE_CONFIG_SSL_SNI_QUERY (http.h)

  • Article

La structure HTTP_SERVICE_CONFIG_SSL_SNI_QUERY est utilisée pour spécifier un enregistrement de certificat SNI (Secure Sockets Layer) particulier à interroger dans le magasin SNI SSL. Il est passé à la fonction HttpQueryServiceConfiguration à l’aide du paramètre pInputConfigInfo lorsque le paramètre ConfigId est défini sur HttpServiceConfigSslSniCertInfo.

Syntaxe

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;

Membres

QueryDesc

L’une des valeurs suivantes de l’énumération HTTP_SERVICE_CONFIG_QUERY_TYPE .

Valeur Signification
HttpServiceConfigQueryExact
 Retourne un enregistrement de certificat SNI SSL unique.
HttpServiceConfigQueryNext
 Retourne une séquence d’enregistrements de certificat SNI SSL dans une séquence d’appels, comme contrôlé par dwToken.

KeyDesc

Si le paramètre QueryDesc est égal à HttpServiceConfigQueryExact, KeyDesc doit contenir une structure HTTP_SERVICE_CONFIG_SSL_SNI_KEY qui identifie l’enregistrement de certificat SNI SSL interrogé. Si le paramètre QueryDesc est égal à HTTPServiceConfigQueryNext, keyDesc est ignoré.

dwToken

Si le paramètre QueryDesc est égal à HTTPServiceConfigQueryNext, dwToken doit être égal à zéro lors du premier appel à la fonction HttpQueryServiceConfiguration , un sur le deuxième appel, deux sur le troisième appel, et ainsi de suite jusqu’à ce que tous les enregistrements de certificat SSL soient retournés, auquel moment HttpQueryServiceConfiguration retourne ERROR_NO_MORE_ITEMS.

Si le paramètre QueryDesc est égal à HttpServiceConfigQueryExact, dwToken est ignoré.

Configuration requise

   
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
En-tête http.h

Voir aussi

HTTP_SERVICE_CONFIG_SSL_SNI_KEY

HTTP_SERVICE_CONFIG_SSL_SNI_SET

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpSetServiceConfiguration