Função HttpSetServiceConfiguration (http.h)
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 |
|---|---|
|
Define um registro na Lista de Escuta de IP. |
|
Define um registro de certificado SSL especificado. |
|
Define um registro de reserva de URL. |
|
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. |
|
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. |
|
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 |
|---|---|
|
HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM estrutura. |
|
HTTP_SERVICE_CONFIG_SSL_SET estrutura. |
|
HTTP_SERVICE_CONFIG_URLACL_SET estrutura. |
|
HTTP_SERVICE_CONFIG_TIMEOUT_SET estrutura. Windows Vista e posterior: Há suporte para essa estrutura. |
|
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. |
|
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 |
|---|---|
|
O registro especificado já existe e deve ser excluído para que seu valor seja definido novamente. |
|
O tamanho do buffer especificado no parâmetro ConfigInformationLength é insuficiente. |
|
O parâmetro ServiceHandle é inválido. |
|
Um ou mais dos parâmetros fornecidos estão em uma forma inutilizável. |
|
O Certificado SSL usado é inválido. Isso só poderá ocorrer se o parâmetro HttpServiceConfigSSLCertInfo for usado. |
|
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