HttpDeleteServiceConfiguration, fonction (http.h)

Article
08/24/2023

La fonction HttpDeleteServiceConfiguration supprime les données spécifiées, telles que les adresses IP ou les certificats SSL, du magasin de configuration de l’API du serveur HTTP, un enregistrement à la fois.

Syntaxe

HTTPAPI_LINKAGE ULONG HttpDeleteServiceConfiguration(
  [in] HANDLE                 ServiceHandle,
  [in] HTTP_SERVICE_CONFIG_ID ConfigId,
  [in] PVOID                  pConfigInformation,
  [in] ULONG                  ConfigInformationLength,
  [in] LPOVERLAPPED           pOverlapped
);

Paramètres

[in] ServiceHandle

Ce paramètre est réservé et doit être égal à zéro.

[in] ConfigId

Type de configuration. Ce paramètre est l’une des valeurs de l’énumération HTTP_SERVICE_CONFIG_ID .

Valeur ConfigId	Signification
HttpServiceConfigIPListenList	Supprime une adresse IP spécifiée de la liste d’écoute IP.
HttpServiceConfigSSLCertInfo	Supprime un enregistrement de certificat SSL spécifié.
HttpServiceConfigUrlAclInfo	Supprime un enregistrement de réservation d’URL spécifié.
HttpServiceConfigTimeout	Supprime un délai de connexion spécifié. Windows Vista et versions ultérieures : Cette énumération est prise en charge.
HttpServiceConfigSslSniCertInfo	Supprime un enregistrement de certificat SNI (Ssl Server Name Indication) spécifié. Windows 8 et versions ultérieures : Cette valeur d’énumération est prise en charge.
HttpServiceConfigSslCcsCertInfo	Supprime l’enregistrement de certificat SSL qui spécifie que Http.sys devez consulter le magasin de certificats centralisé (CCS) pour rechercher les certificats si le port reçoit une négociation TLS (Transport Layer Security). Le port est spécifié par le membre KeyDesc de la structure HTTP_SERVICE_CONFIG_SSL_CCS_SET que vous passez au paramètre pConfigInformation . Windows 8 et versions ultérieures : Cette valeur d’énumération est prise en charge.

[in] pConfigInformation

Pointeur vers une mémoire tampon qui contient les données requises pour le type de configuration spécifié dans le paramètre ConfigId .

Valeur ConfigId	Signification
HttpServiceConfigIPListenList	HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM structure.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET structure.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET structure.
HttpServiceConfigTimeouts	HTTP_SERVICE_CONFIG_TIMEOUT_KEY structure. Windows Vista et versions ultérieures : Cette structure est prise en charge.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_SET structure. Le nom d’hôte est « * » lorsque le magasin de certificats central SSL est interrogé et que des liaisons de caractères génériques sont utilisées, ainsi qu’un nom d’hôte pour la SNI standard. 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] ConfigInformationLength

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

[in] pOverlapped

Réservé pour une opération asynchrone ultérieure. Ce paramètre doit être défini sur NULL.

Valeur retournée

Si la fonction réussit, la fonction retourne NO_ERROR.

Si la fonction échoue, elle retourne l’un des codes d’erreur suivants.

Valeur	Signification
ERROR_INVALID_PARAMETER	L’un des paramètres n’est pas valide.
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

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration

Partager via