Função HttpSetServiceConfiguration (http.h)

  • Artigo

A função HttpSetServiceConfiguration cria e define um registro de configuração para o repositório de configuração da API do Servidor HTTP. A chamada falhará se o registro especificado já existir. Para alterar um determinado registro de configuração, exclua-o e recrie-o com um valor diferente.

Sintaxe

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

Parâmetros

[in] ServiceHandle

Reservado. Deve ser zero.

[in] ConfigId

Tipo de registro de configuração a ser definido. Esse parâmetro pode ser um dos seguintes valores da enumeração HTTP_SERVICE_CONFIG_ID .

Valor de ConfigId Significado
HttpServiceConfigIPListenList
 Define um registro na Lista de Escuta de IP.
HttpServiceConfigSSLCertInfo
 Define um registro de certificado SSL especificado.
HttpServiceConfigUrlAclInfo
 Define um registro de reserva de URL.
HttpServiceConfigTimeout
 Define um tempo limite de conexão de toda a API do Servidor HTTP especificado.

Windows Vista e posterior: Há suporte para esse valor de enumeração.
HttpServiceConfigSslSniCertInfo
 Define um registro de certificado SNI (Indicação de Nome de Servidor) SSL especificado.

Windows 8 e posterior: há suporte para esse valor de enumeração.
HttpServiceConfigSslCcsCertInfo
 Define 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

Um ponteiro para um buffer que contém os dados apropriados para especificar o tipo de registro a ser definido.

Valor de ConfigId Significado
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM estrutura.
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_SET estrutura.
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_SET estrutura.
HttpServiceConfigTimeout

HTTP_SERVICE_CONFIG_TIMEOUT_SET 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 posteriores: há suporte para essa estrutura.
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_SET estrutura.

Windows 8 e posteriores: há suporte para essa estrutura.

[in] ConfigInformationLength

Tamanho, em bytes, do buffer pConfigInformation .

[in] pOverlapped

Esse parâmetro é reservado e deve ser NULL.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos códigos de erro a seguir.

Valor Significado
ERROR_ALREADY_EXISTS
 O registro especificado já existe e deve ser excluído para que seu valor seja definido novamente.
ERROR_INSUFFICIENT_BUFFER
 O tamanho do buffer especificado no parâmetro ConfigInformationLength é insuficiente.
ERROR_INVALID_HANDLE
 O parâmetro ServiceHandle é inválido.
ERROR_INVALID_PARAMETER
 Um ou mais dos parâmetros fornecidos estão em uma forma inutilizável.
ERROR_NO_SUCH_LOGON_SESSION
 O Certificado SSL usado é inválido. Isso só poderá ocorrer se o parâmetro HttpServiceConfigSSLCertInfo for usado.
Outros
 Um código de erro do sistema definido em WinError.h.

Comentários

Os parâmetros de configuração definidos com HttpSetServiceConfiguration são aplicados a todos os aplicativos de API do servidor HTTP no computador e persistem quando a API do servidor HTTP é desligada ou quando o computador é reiniciado.

Requisitos

Requisito Valor
Cliente mínimo com suporte 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

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration