Función HttpDeleteServiceConfiguration (http.h)

La función HttpDeleteServiceConfiguration elimina los datos especificados, como direcciones IP o certificados SSL, del almacén de configuración de la API del servidor HTTP, un registro a la vez.

Syntax

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

Parámetros

[in] ServiceHandle

Este parámetro está reservado y debe ser cero.

[in] ConfigId

Tipo de configuración. Este parámetro es uno de los valores de la enumeración HTTP_SERVICE_CONFIG_ID .

Valor de ConfigId	Meaning
HttpServiceConfigIPListenList	Elimina una dirección IP especificada de la lista de escucha ip.
HttpServiceConfigSSLCertInfo	Elimina un registro de certificado SSL especificado.
HttpServiceConfigUrlAclInfo	Elimina un registro de reserva de direcciones URL especificado.
HttpServiceConfigTimeout	Elimina un tiempo de espera de conexión especificado. Windows Vista y versiones posteriores: Esta enumeración se admite.
HttpServiceConfigSslSniCertInfo	Elimina un registro de certificado de indicación de nombre de servidor SSL (SNI) especificado. Windows 8 y versiones posteriores: Este valor de enumeración se admite.
HttpServiceConfigSslCcsCertInfo	Elimina el registro de certificado SSL que especifica que Http.sys debe consultar el almacén de almacén de certificados centralizado (CCS) para buscar certificados si el puerto recibe un protocolo de enlace de seguridad de la capa de transporte (TLS). El puerto se especifica mediante el miembro KeyDesc de la estructura HTTP_SERVICE_CONFIG_SSL_CCS_SET que se pasa al parámetro pConfigInformation . Windows 8 y versiones posteriores: Este valor de enumeración se admite.

[in] pConfigInformation

Puntero a un búfer que contiene los datos necesarios para el tipo de configuración especificado en el parámetro ConfigId .

Valor de ConfigId	Meaning
HttpServiceConfigIPListenList	estructura HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM .
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET estructura.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET estructura.
HttpServiceConfigTimeouts	estructura HTTP_SERVICE_CONFIG_TIMEOUT_KEY . Windows Vista y versiones posteriores: Esta estructura es compatible.
HttpServiceConfigSslSniCertInfo	estructura HTTP_SERVICE_CONFIG_SSL_SNI_SET . El nombre de host será "*" cuando se consulte el almacén de certificados central SSL y se usen enlaces comodín y un nombre de host para SNI normal. Windows 8 y versiones posteriores: Esta estructura es compatible.
HttpServiceConfigSslCcsCertInfo	estructura de HTTP_SERVICE_CONFIG_SSL_CCS_SET . Windows 8 y versiones posteriores: Esta estructura es compatible.

[in] ConfigInformationLength

Tamaño, en bytes, del búfer pConfigInformation .

[in] pOverlapped

Reservado para futuras operaciones asincrónicas. Este parámetro debe establecerse en NULL.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve NO_ERROR.

Si se produce un error en la función, devuelve uno de los siguientes códigos de error.

Importancia	Meaning
ERROR_INVALID_PARAMETER	Uno de los parámetros no es válido.
Otros	Código de error del sistema definido en WinError.h.

Requisitos

Requirement	Importancia
Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
Header	http.h
Library	Httpapi.lib
DLL de	Httpapi.dll

Consulte también

Funciones de LA API de servidor HTTP versión 1.0

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration