Função InternetQueryOptionA (wininet.h)

Artigo
03/13/2024

Consulta uma opção de Internet no identificador especificado.

Sintaxe

BOOL InternetQueryOptionA(
  [in]      HINTERNET hInternet,
  [in]      DWORD     dwOption,
  [out]     LPVOID    lpBuffer,
  [in, out] LPDWORD   lpdwBufferLength
);

Parâmetros

[in] hInternet

Identificador no qual consultar informações.

[in] dwOption

Opção de Internet a ser consultada. Esse pode ser um dos valores de Sinalizadores de Opção .

[out] lpBuffer

Ponteiro para um buffer que recebe a configuração de opção. As cadeias de caracteres retornadas por InternetQueryOption são alocadas globalmente, portanto, o aplicativo de chamada deve liberá-las quando terminar de usá-las.

[in, out] lpdwBufferLength

Ponteiro para uma variável que contém o tamanho de lpBuffer, em bytes. Quando InternetQueryOption retorna, lpdwBufferLength especifica o tamanho dos dados colocados em lpBuffer. Se GetLastError retornar ERROR_INSUFFICIENT_BUFFER, esse parâmetro apontará para o número de bytes necessários para manter as informações solicitadas.

Retornar valor

Retornará TRUE se tiver êxito ou FALSE caso contrário. Para obter uma mensagem de erro específica, chame GetLastError.

Comentários

GetLastError retornará o ERROR_INVALID_PARAMETER se um sinalizador de opção inválido para o tipo de identificador especificado for passado para o parâmetro dwOption .

Para obter mais informações, consulte
Configurando e recuperando opções da Internet.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro de DllMain ou dos construtores e destruidores de objetos globais.

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações de servidor ou serviços, use Os Serviços HTTP do Microsoft Windows (WinHTTP).

Observação

O cabeçalho wininet.h define InternetQueryOption como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wininet.h
Biblioteca	Wininet.lib
DLL	Wininet.dll