Fonction HttpQueryServiceConfiguration (http.h)
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 |
---|---|
|
Interroge la liste d’écoute IP. |
|
Interroge le magasin SSL pour un enregistrement de certificat spécifique. |
|
Interroge les informations de réservation d’URL. |
|
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. |
|
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. |
|
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 |
---|---|
|
Aucune donnée d’entrée ; défini sur NULL. |
|
HTTP_SERVICE_CONFIG_SSL_QUERY structure. |
|
HTTP_SERVICE_CONFIG_URLACL_QUERY structure. |
|
HTTP_SERVICE_CONFIG_TIMEOUT_KEY structure. Windows Vista et versions ultérieures : Cette structure est prise en charge. |
|
HTTP_SERVICE_CONFIG_SSL_SNI_QUERY structure. Windows 8 et versions ultérieures : cette structure est prise en charge. |
|
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 |
---|---|
|
HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY structure. |
|
HTTP_SERVICE_CONFIG_SSL_SET structure. |
|
HTTP_SERVICE_CONFIG_URLACL_SET structure. |
|
HTTP_SERVICE_CONFIG_TIMEOUT_PARAM type de données. Windows Vista et versions ultérieures : Cette structure est prise en charge. |
|
HTTP_SERVICE_CONFIG_SSL_SNI_SET structure. Windows 8 et versions ultérieures : cette structure est prise en charge. |
|
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 |
---|---|
|
L’un des paramètres n’est pas valide. |
|
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. |
|
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. |
|
Il n’y a plus d’éléments à retourner qui répondent aux critères spécifiés. |
|
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour