HttpDeleteServiceConfiguration, fonction (http.h)

  • Article

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