Função HttpQueryServiceConfiguration (http.h)

  • Artigo

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