estrutura INTERNET_PER_CONN_OPTIONW (wininet.h)

  • Artigo

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 valores a seguir.

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
Sem 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 válida conhecida foi encontrada usando a descoberta automática.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL
 Opção somente leitura. Retorna a última URL válida conhecida encontrada usando a descoberta automática.
 

Windows 7 e posterior:

Os clientes que dão suporte à Internet Explorer 8 devem consultar o tipo de conexão usando INTERNET_PER_CONN_FLAGS_UI. Se essa consulta falhar, o sistema estará executando uma versão anterior do Explorer da Internet 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 Explorer da Internet.

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 FILETIME .

Value.dwValue

Valor inteiro longo sem sinal.

Value.pszValue

Ponteiro para um valor de cadeia de caracteres.

Value.ftValue

Uma estrutura FILETIME .

Comentários

Na 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 INTERNET_PER_CONN_OPTION em versões posteriores do Explorer da Internet.

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.

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

Confira também

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption

InternetSetOption