Función HttpDeleteServiceConfiguration (http.h)

  • Artículo

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 cada vez.

Sintaxis

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 configId Significado
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: Se admite este valor de enumeración.
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 lo especifica el miembro KeyDesc de la estructura HTTP_SERVICE_CONFIG_SSL_CCS_SET que se pasa al parámetro pConfigInformation .

Windows 8 y versiones posteriores: Se admite este valor de enumeración.

[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 configId Significado
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM estructura.
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_SET estructura.
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_SET estructura.
HttpServiceConfigTimeouts

HTTP_SERVICE_CONFIG_TIMEOUT_KEY estructura.

Windows Vista y versiones posteriores: Se admite esta estructura.
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_SET estructura. 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: Se admite esta estructura.
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_SET estructura.

Windows 8 y versiones posteriores: Se admite esta estructura.

[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.

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

Requisitos

   
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado http.h
Library Httpapi.lib
Archivo DLL Httpapi.dll

Consulte también

Funciones de la API de servidor HTTP versión 1.0

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration