Fonction HttpQueryServiceConfiguration (http.h)

  • Article

La fonction HttpQueryServiceConfiguration récupère un ou plusieurs enregistrements de configuration de l’API du serveur HTTP.

Syntaxe

HTTPAPI_LINKAGE ULONG HttpQueryServiceConfiguration(
  [in]                HANDLE                 ServiceHandle,
  [in]                HTTP_SERVICE_CONFIG_ID ConfigId,
  [in, optional]      PVOID                  pInput,
  [in, optional]      ULONG                  InputLength,
  [in, out, optional] PVOID                  pOutput,
  [in, optional]      ULONG                  OutputLength,
  [out, optional]     PULONG                 pReturnLength,
  [in]                LPOVERLAPPED           pOverlapped
);

Paramètres

[in] ServiceHandle

Réservé. Doit être zéro.

[in] ConfigId

Type de requête d’enregistrement de configuration. Ce paramètre est l’une des valeurs suivantes de
HTTP_SERVICE_CONFIG_ID énumération.

Valeur configId Signification
HttpServiceConfigIPListenList
 Interroge la liste d’écoute IP.
HttpServiceConfigSSLCertInfo
 Interroge le magasin SSL pour un enregistrement de certificat spécifique.
HttpServiceConfigUrlAclInfo
 Interroge les informations de réservation d’URL.
HttpServiceConfigTimeout
 Interroge les délais d’expiration de connexion à l’échelle de l’API serveur HTTP.

Windows Vista et versions ultérieures : Cette énumération est prise en charge.
HttpServiceConfigSslSniCertInfo
 Interroge le magasin SNI (Ssl Server Name Indication) pour un enregistrement de certificat spécifique.

Windows 8 et versions ultérieures : cette valeur d’énumération est prise en charge.
HttpServiceConfigSslCcsCertInfo
 Interroge la configuration SSL d’un enregistrement CCS (Centralized Certificate Store) SSL sur le port. Le port est spécifié par le membre KeyDesc de la structure HTTP_SERVICE_CONFIG_SSL_CCS_QUERY que vous passez au paramètre pInputConfigInfo .

Windows 8 et versions ultérieures : cette valeur d’énumération est prise en charge.

[in, optional] pInput

Pointeur vers une structure dont le contenu définit davantage la requête et du type qui correspond à ConfigId dans le tableau suivant.

Valeur configId Signification
HttpServiceConfigIPListenList
 Aucune donnée d’entrée ; défini sur NULL.
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_QUERY structure.
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_QUERY structure.
HttpServiceConfigTimeout

HTTP_SERVICE_CONFIG_TIMEOUT_KEY structure.

Windows Vista et versions ultérieures : Cette structure est prise en charge.
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_QUERY structure.

Windows 8 et versions ultérieures : cette structure est prise en charge.
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_QUERY structure.

Windows 8 et versions ultérieures : cette structure est prise en charge.
 

Pour plus d’informations, consultez les structures de requête appropriées.

[in, optional] InputLength

Taille, en octets, de la mémoire tampon pInputConfigInfo .

[in, out, optional] pOutput

Pointeur vers une mémoire tampon dans laquelle les résultats de la requête sont retournés. Le type de cette mémoire tampon est corrélé avec ConfigId.

Valeur configId Signification
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY structure.
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_SET structure.
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_SET structure.
HttpServiceConfigTimeout

HTTP_SERVICE_CONFIG_TIMEOUT_PARAM type de données.

Windows Vista et versions ultérieures : Cette structure est prise en charge.
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_SET structure.

Windows 8 et versions ultérieures : cette structure est prise en charge.
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_SET structure.

Windows 8 et versions ultérieures : cette structure est prise en charge.

[in, optional] OutputLength

Taille, en octets, de la mémoire tampon pOutputConfigInfo .

[out, optional] pReturnLength

Pointeur vers une variable qui reçoit le nombre d’octets à écrire dans la mémoire tampon de sortie. Si la mémoire tampon de sortie est trop petite, l’appel échoue avec une valeur de retour de ERROR_INSUFFICIENT_BUFFER. La valeur pointée par pReturnLength peut être utilisée pour déterminer la longueur minimale requise par la mémoire tampon pour que l’appel réussisse.

[in] pOverlapped

Réservé pour l’opération asynchrone et doit être défini sur NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur Signification
ERROR_INVALID_PARAMETER
 L’un des paramètres n’est pas valide.
ERROR_INSUFFICIENT_BUFFER
 La mémoire tampon pointée par pOutputConfigInfo est trop petite pour recevoir les données de sortie. Appelez à nouveau la fonction avec une mémoire tampon au moins aussi grande que la taille indiquée par pReturnLength à la sortie.
ERROR_MORE_DATA
 La mémoire tampon pointée par pOutputConfigInfo est trop petite pour recevoir les données de sortie. Appelez à nouveau la fonction avec une mémoire tampon au moins aussi grande que la taille indiquée par pReturnLength à la sortie.
ERROR_NO_MORE_ITEMS
 Il n’y a plus d’éléments à retourner qui répondent aux critères spécifiés.
Autres
 Code d’erreur système défini dans WinError.h.

Configuration requise

   
Client minimal pris en charge Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête http.h
Bibliothèque Httpapi.lib
DLL Httpapi.dll

Voir aussi

Fonctions de l’API serveur HTTP version 1.0

HttpDeleteServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration