Função HttpDeleteServiceConfiguration (http.h)

Artigo
08/24/2023

A função HttpDeleteServiceConfiguration exclui dados especificados, como endereços IP ou Certificados SSL, do repositório de configuração da API do Servidor HTTP, um registro por vez.

Sintaxe

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

Esse parâmetro é reservado e precisa ser zero.

[in] ConfigId

Tipo de configuração. Esse parâmetro é um dos valores na enumeração HTTP_SERVICE_CONFIG_ID .

Valor ConfigId	Significado
HttpServiceConfigIPListenList	Exclui um endereço IP especificado da Lista de Escutas ip.
HttpServiceConfigSSLCertInfo	Exclui um registro de certificado SSL especificado.
HttpServiceConfigUrlAclInfo	Exclui um registro de reserva de URL especificado.
HttpServiceConfigTimeout	Exclui um tempo limite de conexão especificado. Windows Vista e posterior: Há suporte para essa enumeração.
HttpServiceConfigSslSniCertInfo	Exclui um registro de certificado SNI (Indicação de Nome do Servidor SSL) especificado. Windows 8 e posterior: Há suporte para esse valor de enumeração.
HttpServiceConfigSslCcsCertInfo	Exclui o registro de certificado SSL que especifica que Http.sys deve consultar o repositório ccs (repositório de certificados centralizado) para localizar certificados se a porta receber um handshake TLS (Transport Layer Security). A porta é especificada pelo membro KeyDesc da estrutura HTTP_SERVICE_CONFIG_SSL_CCS_SET que você passa para o parâmetro pConfigInformation . Windows 8 e posterior: Há suporte para esse valor de enumeração.

[in] pConfigInformation

Ponteiro para um buffer que contém dados necessários para o tipo de configuração especificado no parâmetro ConfigId .

Valor ConfigId	Significado
HttpServiceConfigIPListenList	HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM estrutura.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET estrutura.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET estrutura.
HttpServiceConfigTimeouts	HTTP_SERVICE_CONFIG_TIMEOUT_KEY estrutura. Windows Vista e posterior: Há suporte para essa estrutura.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_SET estrutura. O nome do host será "" quando o repositório de certificados central SSL for consultado e as associações curinga forem usadas e um nome de host para SNI regular. Windows 8 e posterior:* Há suporte para essa estrutura.
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_SET estrutura. Windows 8 e posterior: Há suporte para essa estrutura.

[in] ConfigInformationLength

Tamanho, em bytes, do buffer pConfigInformation .

[in] pOverlapped

Reservado para futura operação assíncrona. Esse parâmetro deve ser definido como NULL.

Valor retornado

Se a função for bem-sucedida, a função retornará NO_ERROR.

Se a função falhar, ela retornará um dos seguintes códigos de erro.

Valor	Significado
ERROR_INVALID_PARAMETER	Um dos parâmetros é inválido.
Outros	Um código de erro do sistema definido em WinError.h.

Requisitos


Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	http.h
Biblioteca	Httpapi.lib
DLL	Httpapi.dll

Confira também

Funções da API do Servidor HTTP versão 1.0

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration

Compartilhar via