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