Função InternetSetOptionA (wininet.h)

Artigo
11/20/2024

Define uma opção de Internet.

Sintaxe

BOOL InternetSetOptionA(
  [in] HINTERNET hInternet,
  [in] DWORD     dwOption,
  [in] LPVOID    lpBuffer,
  [in] DWORD     dwBufferLength
);

Parâmetros

[in] hInternet

Manipule no qual definir informações.

[in] dwOption

Opção de Internet a ser definida. Esse pode ser um dos valores de de sinalizadores de opção .

[in] lpBuffer

Ponteiro para um buffer que contém a configuração de opção.

[in] dwBufferLength

Tamanho do buffer lpBuffer. Se lpBuffer contiver uma cadeia de caracteres, o tamanho estará em TCHARs. Se lpBuffer contiver qualquer outra coisa que não seja uma cadeia de caracteres, o tamanho estará em bytes.

Valor de retorno

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

Observações

GetLastError retornará o erro ERROR_INVALID_PARAMETER se um sinalizador de opção que não puder ser definido for especificado.

Para obter mais informações, consulte Configuração e Recuperação de Opções da Internet.

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

Observaçã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 ou serviços de servidor, use do Microsoft Windows HTTP Services (WinHTTP).

Nota

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wininet.h
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

funções comuns

FtpGetFile

FtpPutFile

InternetConnect

InternetOpen

InternetQueryOption

do WinINet Functions

Compartilhar via