Função HttpQueryServiceConfiguration (http.h)

Artigo
01/11/2024

A função HttpQueryServiceConfiguration recupera um ou mais registros de configuração da API do Servidor HTTP.

Sintaxe

HTTPAPI_LINKAGE ULONG HttpQueryServiceConfiguration(
  [in]                HANDLE                 ServiceHandle,
  [in]                HTTP_SERVICE_CONFIG_ID ConfigId,
  [in, optional]      PVOID                  pInput,
  [in, optional]      ULONG                  InputLength,
  [in, out, optional] PVOID                  pOutput,
  [in, optional]      ULONG                  OutputLength,
  [out, optional]     PULONG                 pReturnLength,
  [in]                LPOVERLAPPED           pOverlapped
);

Parâmetros

[in] ServiceHandle

Reservado. Deve ser zero.

[in] ConfigId

O tipo de consulta de registro de configuração. Esse parâmetro é um dos seguintes valores do
HTTP_SERVICE_CONFIG_ID enumeração.

Valor de ConfigId	Significado
HttpServiceConfigIPListenList	Consulta a lista de escuta de IP.
HttpServiceConfigSSLCertInfo	Consulta o repositório SSL para obter um registro de certificado específico.
HttpServiceConfigUrlAclInfo	Consulta informações de reserva de URL.
HttpServiceConfigTimeout	Consulta tempos limite de conexão de toda a API do Servidor HTTP. Windows Vista e posterior: Há suporte para essa enumeração.
HttpServiceConfigSslSniCertInfo	Consulta o repositório SNI (Indicação de Nome de Servidor) do SSL para obter um registro de certificado específico. Windows 8 e posterior: há suporte para esse valor de enumeração.
HttpServiceConfigSslCcsCertInfo	Consulta a configuração de SSL para um registro CCS (Repositório de Certificados Centralizado) SSL na porta. A porta é especificada pelo membro KeyDesc da estrutura HTTP_SERVICE_CONFIG_SSL_CCS_QUERY que você passa para o parâmetro pInputConfigInfo . Windows 8 e posterior: há suporte para esse valor de enumeração.

[in, optional] pInput

Um ponteiro para uma estrutura cujo conteúdo define ainda mais a consulta e o tipo que se correlaciona com ConfigId na tabela a seguir.

Valor de ConfigId	Significado
HttpServiceConfigIPListenList	Sem dados de entrada; defina como NULL.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_QUERY estrutura.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_QUERY estrutura.
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_KEY estrutura. Windows Vista e posterior: Há suporte para essa estrutura.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_QUERY estrutura. Windows 8 e posteriores: há suporte para essa estrutura.
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_QUERY estrutura. Windows 8 e posteriores: há suporte para essa estrutura.

Para obter mais informações, consulte as estruturas de consulta apropriadas.

[in, optional] InputLength

Tamanho, em bytes, do buffer pInputConfigInfo .

[in, out, optional] pOutput

Um ponteiro para um buffer no qual os resultados da consulta são retornados. O tipo desse buffer se correlaciona com ConfigId.

Valor de ConfigId	Significado
HttpServiceConfigIPListenList	HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY estrutura.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET estrutura.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET estrutura.
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_PARAM tipo de dados. Windows Vista e posterior: Há suporte para essa estrutura.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_SET estrutura. 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, optional] OutputLength

Tamanho, em bytes, do buffer pOutputConfigInfo .

[out, optional] pReturnLength

Um ponteiro para uma variável que recebe o número de bytes a serem gravados no buffer de saída. Se o buffer de saída for muito pequeno, a chamada falhará com um valor retornado de ERROR_INSUFFICIENT_BUFFER. O valor apontado por pReturnLength pode ser usado para determinar o comprimento mínimo que o buffer requer para que a chamada seja bem-sucedida.

[in] pOverlapped

Reservado para operação assíncrona e deve ser definido como 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_INVALID_PARAMETER	Um dos parâmetros é inválido.
ERROR_INSUFFICIENT_BUFFER	O buffer apontado por pOutputConfigInfo é muito pequeno para receber os dados de saída. Chame a função novamente com um buffer pelo menos tão grande quanto o tamanho apontado por pReturnLength na saída.
ERROR_MORE_DATA	O buffer apontado por pOutputConfigInfo é muito pequeno para receber os dados de saída. Chame a função novamente com um buffer pelo menos tão grande quanto o tamanho apontado por pReturnLength na saída.
ERROR_NO_MORE_ITEMS	Não há mais itens a serem retornados que atendam aos critérios especificados.
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

HttpDeleteServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration

Compartilhar via