Fonction HttpQueryServiceConfiguration (http.h)

Article
01/11/2024

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

Partager via