structure HTTP_SERVICE_CONFIG_SSL_CCS_QUERY (http.h)

  • Article

Spécifie une configuration SSL (Secure Sockets Layer) pour rechercher un enregistrement CCS (Centralized Certificate Store) SSL sur le port lorsque vous appelez la fonction HttpQueryServiceConfiguration . L’enregistrement de certificat SSL spécifie que Http.sys devez consulter le magasin CCS pour rechercher les certificats si le port reçoit une négociation TLS (Transport Layer Security).

Syntaxe

typedef struct _HTTP_SERVICE_CONFIG_SSL_CCS_QUERY {
  HTTP_SERVICE_CONFIG_QUERY_TYPE  QueryDesc;
  HTTP_SERVICE_CONFIG_SSL_CCS_KEY KeyDesc;
  DWORD                           dwToken;
} HTTP_SERVICE_CONFIG_SSL_CCS_QUERY, *PHTTP_SERVICE_CONFIG_SSL_CCS_QUERY;

Membres

QueryDesc

L’une des valeurs suivantes de l’énumération HTTP_SERVICE_CONFIG_QUERY_TYPE qui indique si l’appel à HttpQueryServiceConfiguration est un appel pour récupérer un enregistrement unique ou une partie d’une séquence d’appels pour récupérer une séquence d’enregistrements.

Valeur Signification
HttpServiceConfigQueryExact
 L’appel à HttpQueryServiceConfiguration est appelé pour récupérer un seul enregistrement de certificat CCS SSL, que le membre KeyDesc spécifie.
HttpServiceConfigQueryNext
 L’appel à HttpQueryServiceConfiguration fait partie d’une séquence d’appels permettant de récupérer une séquence d’enregistrements de certificat SSL CCS. La valeur du membre dwToken contrôle l’enregistrement dans la séquence que cet appel à HttpQueryServiceConfiguration récupère.

KeyDesc

Une structure HTTP_SERVICE_CONFIG_SSL_CCS_KEY qui identifie l’enregistrement de certificat CCS SSL interrogé, si le membre QueryDesc est égal à HttpServiceConfigQueryExact. Ignoré si QueryDesc est égal à HTTPServiceConfigQueryNext.

dwToken

Position de l’enregistrement dans la séquence d’enregistrements que cet appel à HttpQueryServiceConfiguration doit récupérer si la méthode QueryDesc est égale à HTTPServiceConfigQueryNext, à partir de zéro. En d’autres termes, dwToken doit être égal à zéro sur le premier appel à la fonction HttpQueryServiceConfiguration , un sur le deuxième appel, deux sur le troisième appel, et ainsi de suite. Lorsque la séquence d’appels a retourné tous les enregistrements de certificat SSL, HttpQueryServiceConfiguration retourne ERROR_NO_MORE_ITEMS. Ignoré si QueryDesc est égal à HttpServiceConfigQueryExact.

Remarques

Transmettez cette structure à la fonction HttpQueryServiceConfiguration à l’aide du paramètre pInputConfigInfo lorsque le paramètre ConfigId est défini sur HttpServiceConfigSslCcsCertInfo.

Configuration requise

Condition requise Valeur
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_QUERY_TYPE

HTTP_SERVICE_CONFIG_SSL_CCS_KEY

HttpQueryServiceConfiguration