estrutura INTERNET_PER_CONN_OPTIONW (wininet.h)

Contém o valor de uma opção.

Sintaxe

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPWSTR   pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONW, *LPINTERNET_PER_CONN_OPTIONW;

Membros

dwOption

Opção a ser consultada ou definida. Esse membro pode ser um dos seguintes valores.

Valor	Significado
INTERNET_PER_CONN_AUTOCONFIG_URL	Define ou recupera uma cadeia de caracteres que contém a URL para o script de configuração automática.
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS	Define ou recupera as configurações de descoberta automática. O membro Value conterá um ou mais dos seguintes valores: AUTO_PROXY_FLAG_ALWAYS_DETECT Sempre detecte automaticamente as configurações. AUTO_PROXY_FLAG_CACHE_INIT_RUN Indica que os resultados armazenados em cache do script de configuração de proxy automático devem ser usados, em vez de realmente executar o script, a menos que o arquivo armazenado em cache tenha expirado. AUTO_PROXY_FLAG_DETECTION_RUN A detecção automática foi executada pelo menos uma vez nessa conexão. AUTO_PROXY_FLAG_DETECTION_SUSPECT Não há suporte no momento. AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT Não permita o cache do resultado do script de configuração de proxy automático. AUTO_PROXY_FLAG_MIGRATED A configuração foi migrada de uma instalação do Microsoft Internet Explorer 4.0 e a detecção automática deve ser tentada uma vez. AUTO_PROXY_FLAG_USER_SET O usuário definiu explicitamente a detecção automática.
INTERNET_PER_CONN_FLAGS	Define ou recupera o tipo de conexão. O membro Value conterá um ou mais dos seguintes valores: PROXY_TYPE_DIRECT A conexão não usa um servidor proxy. PROXY_TYPE_PROXY A conexão usa um servidor proxy definido explicitamente. PROXY_TYPE_AUTO_PROXY_URL A conexão baixa e processa um script de configuração automática em uma URL especificada. PROXY_TYPE_AUTO_DETECT A conexão detecta automaticamente as configurações.
INTERNET_PER_CONN_PROXY_BYPASS	Define ou recupera uma cadeia de caracteres que contém as URLs que não usam o servidor proxy.
INTERNET_PER_CONN_PROXY_SERVER	Define ou recupera uma cadeia de caracteres que contém os servidores proxy.
INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL	URL de configuração automática encadeada. Usado quando a URL de configuração automática primária aponta para um arquivo INS que define uma segunda URL de configuração automática para informações de proxy.
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS	de minutos até a atualização automática da URL de configuração automática por descoberta automática.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME	Opção somente leitura. Retorna a hora em que a última URL de configuração automática conhecida foi encontrada usando a descoberta automática.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL	Opção somente leitura. Retorna a última URL boa conhecida encontrada usando descoberta automática.

 

Windows 7 e posterior:

Os clientes que dão suporte ao Internet Explorer 8 devem consultar o tipo de conexão usando INTERNET_PER_CONN_FLAGS_UI. Se essa consulta falhar, o sistema executará uma versão anterior do Internet Explorer e o cliente deverá consultar novamente com INTERNET_PER_CONN_FLAGS.

Restaure o tipo de conexão usando INTERNET_PER_CONN_FLAGS independentemente da versão do Internet Explorer.

Valor

Significado

INTERNET_PER_CONN_FLAGS_UI

Define ou recupera o tipo de conexão. O membro Value conterá um ou mais dos seguintes valores: PROXY_TYPE_DIRECT A conexão não usa um servidor proxy. PROXY_TYPE_PROXY A conexão usa um servidor proxy definido explicitamente. PROXY_TYPE_AUTO_PROXY_URL A conexão baixa e processa um script de configuração automática em uma URL especificada. PROXY_TYPE_AUTO_DETECT A conexão detecta automaticamente as configurações.

Value

União que contém o valor da opção. Pode ser qualquer um dos seguintes tipos, dependendo do valor de dwOption:

dwValue

Valor inteiro longo sem sinal.

pszValue

Ponteiro para um valor de cadeia de caracteres.

ftValue

Uma estrutura de FILETIME.

Value.dwValue

Valor inteiro longo sem sinal.

Value.pszValue

Ponteiro para um valor de cadeia de caracteres.

Value.ftValue

Uma estrutura de FILETIME.

Observações

No Internet Explorer 5, somente as versões ANSI de InternetQueryOption e InternetSetOption funcionarão com a estrutura INTERNET_PER_CONN_OPTION. As versões unicode darão suporte à estrutura de INTERNET_PER_CONN_OPTION em versões posteriores do Internet Explorer.

Para consultas que retornam cadeias de caracteres, InternetQueryOption aloca a memória para o membro pszValue da estrutura. O aplicativo de chamada deve liberar essa memória usando a função GlobalFree quando terminar de usar a cadeia de caracteres.

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 INTERNET_PER_CONN_OPTION 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]
cabeçalho	wininet.h

Consulte também

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption

InternetSetOption