Sinalizadores de opção (Wininet.h)

Os sinalizadores de opção a seguir são usados com as funções InternetQueryOption e InternetSetOption . Todos os sinalizadores de opção válidos têm um valor maior ou igual a INTERNET_FIRST_OPTION e menor ou igual a INTERNET_LAST_OPTION.

INTERNET_OPTION_ALTER_IDENTITY

80

Não implementado

INTERNET_OPTION_ASYNC

30

Não implementado.

INTERNET_OPTION_ASYNC_ID

15

Não implementado.

INTERNET_OPTION_ASYNC_PRIORITY

16

Não implementado.

INTERNET_OPTION_BYPASS_EDITED_ENTRY

64

Define ou recupera o valor booliano que determina se o sistema deve marcar a rede para conteúdo mais recente e substituir entradas de cache editadas se uma versão mais recente for encontrada. Se definido como True, o sistema verificará se há conteúdo mais recente na rede e substituirá a entrada de cache editada pela versão mais recente. O padrão é False, que indica que a entrada de cache editada deve ser usada sem verificar a rede. Isso é usado por InternetQueryOption e InternetSetOption. Ela é válida somente na Internet da Microsoft Explorer 5 e posteriores.

INTERNET_OPTION_CACHE_STREAM_HANDLE

27

Não tem mais suporte.

INTERNET_OPTION_CACHE_TIMESTAMPS

69

Recupera uma estrutura INTERNET_CACHE_TIMESTAMPS que contém a hora LastModified e Expira a hora do recurso armazenado no cache da Internet. Esse valor é usado por InternetQueryOption.

INTERNET_OPTION_CALLBACK

1

Define ou recupera o endereço da função de retorno de chamada definida para esse identificador. Essa opção pode ser usada em todos os identificadores HINTERNET . Usado por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CALLBACK_FILTER

54

Não implementado.

INTERNET_OPTION_CLIENT_CERT_CONTEXT

84

Não há suporte para esse sinalizador no InternetQueryOption. O parâmetro lpBuffer deve ser um ponteiro para uma estrutura CERT_CONTEXT e não um ponteiro para um ponteiro CERT_CONTEXT . Se um aplicativo receber ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED, ele deverá chamar InternetErrorDlg ou usar InternetSetOption para fornecer um certificado antes de tentar novamente a solicitação. CertDuplicateCertificateContext é chamado para que o contexto do certificado passado possa ser liberado independentemente pelo aplicativo.

INTERNET_OPTION_CODEPAGE

68

Por padrão, a parte de host ou autoridade da URL Unicode é codificada de acordo com a especificação de IDN. Definir essa opção na solicitação ou no identificador de conexão, quando o IDN estiver desabilitado, especifica um esquema de codificação de página de código para a parte de host da URL. O parâmetro lpBuffer na chamada para InternetSetOption contém a página de código DBCS desejada. Se nenhuma página de código for especificada no lpBuffer, o WinINet usará a página de código do sistema padrão (CP_ACP). Observação: essa opção será ignorada se o IDN não estiver desabilitado. Para obter mais informações sobre como desabilitar o IDN, consulte a opção INTERNET_OPTION_IDN .

Windows XP com SP2 e Windows Server 2003 com SP1: Não há suporte para esse sinalizador.

Versão: Requer a Internet Explorer 7.0.

INTERNET_OPTION_CODEPAGE_PATH

100

Por padrão, a parte do caminho da URL é codificada em UTF8. A API WinINet executa a codificação de caracteres de escape (%) nos caracteres de bit alto. Definir essa opção na solicitação ou no identificador de conexão desabilita a codificação UTF8 e define uma página de código específica. O parâmetro lpBuffer na chamada para InternetSetOption contém a página de código DBCS desejada para o caminho. Se nenhuma página de código for especificada no lpBuffer, o WinINet usará o CP_UTF8 padrão.

Windows XP com SP2 e Windows Server 2003 com SP1: Não há suporte para esse sinalizador.

Versão: Requer a Internet Explorer 7.0.

INTERNET_OPTION_CODEPAGE_EXTRA

101

Por padrão, a parte do caminho da URL é a página de código do sistema padrão (CP_ACP). As conversões de caractere de escape (%) não são executadas na parte extra. Definir essa opção na solicitação ou o identificador de conexão desabilita a codificação CP_ACP. O parâmetro lpBuffer na chamada para InternetSetOption contém a página de código DBCS desejada para a parte extra da URL. Se nenhuma página de código for especificada no lpBuffer, o WinINet usará a página de código do sistema padrão (CP_ACP).

Windows XP com SP2 e Windows Server 2003 com SP1: Não há suporte para esse sinalizador.

Versão: Requer a Internet Explorer 7.0.

INTERNET_OPTION_COMPRESSED_CONTENT_LENGTH

147

Para uma solicitação em que o WinInet descompactou a Codificação de Conteúdo fornecida pelo servidor, recupera o Content-Length relatado pelo servidor do corpo da resposta como um ULONGLONG. Com suporte no Windows 10, versão 1507 e posterior.

INTERNET_OPTION_CONNECT_BACKOFF

4

Não implementado.

INTERNET_OPTION_CONNECT_RETRIES

3

Define ou recupera um valor inteiro longo sem sinal que contém o número de vezes que a WinINet tenta resolve e se conectar a um host. Ele só tenta uma vez por endereço IP. Por exemplo, se você tentar se conectar a um host multihome que tenha dez endereços IP e INTERNET_OPTION_CONNECT_RETRIES estiver definido como sete, a WinINet tentará apenas resolve e se conectar aos sete primeiros endereços IP. Por outro lado, considerando o mesmo conjunto de dez endereços IP, se INTERNET_OPTION_CONNECT_RETRIES estiver definido como 20, o WinINet tentará cada um dos dez apenas uma vez. Se um host tiver apenas um endereço IP e a primeira tentativa de conexão falhar, não haverá mais tentativas. Se uma tentativa de conexão ainda falhar após o número especificado de tentativas, a solicitação será cancelada. O valor padrão para INTERNET_OPTION_CONNECT_RETRIES é cinco tentativas. Essa opção pode ser usada em qualquer identificador HINTERNET , incluindo um identificador NULL . Ele é usado por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CONNECT_TIME

55

Não implementado.

INTERNET_OPTION_CONNECT_TIMEOUT

2

Define ou recupera um valor inteiro longo sem sinal que contém o valor de tempo limite, em milissegundos, a ser usado para solicitações de conexão com a Internet. Definir essa opção como infinita (0xFFFFFFFF) desabilitará esse temporizador.

Se uma solicitação de conexão demorar mais do que esse valor de tempo limite, a solicitação será cancelada. Ao tentar se conectar a vários endereços IP para um único host (um host multihome), o limite de tempo limite é cumulativo para todos os endereços IP. Essa opção pode ser usada em qualquer identificador HINTERNET , incluindo um identificador NULL . Ele é usado por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CONNECTED_STATE

50

Define ou recupera um valor inteiro longo sem sinal que contém o estado conectado. Isso é usado por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CONTEXT_VALUE

45

Define ou recupera um DWORD_PTR que contém o endereço do valor de contexto associado a esse identificador HINTERNET . Essa opção pode ser usada em qualquer identificador HINTERNET . Isso é usado por InternetQueryOption e InternetSetOption. Anteriormente, isso definia o valor de contexto para o endereço armazenado no ponteiro lpBuffer . Isso foi corrigido para que o valor armazenado no buffer seja usado e o sinalizador INTERNET_OPTION_CONTEXT_VALUE seja atribuído a um novo valor. O valor antigo, 10, foi preservado para que os aplicativos gravados para o comportamento antigo ainda sejam compatíveis.

INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT

6

Idêntico a INTERNET_OPTION_RECEIVE_TIMEOUT. Isso é usado por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CONTROL_SEND_TIMEOUT

5

Idêntico a INTERNET_OPTION_SEND_TIMEOUT. Isso é usado por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_DATA_RECEIVE_TIMEOUT

8

Define ou recupera um valor inteiro longo sem sinal que contém o valor de tempo limite, em milissegundos, para receber uma resposta a uma solicitação para o canal de dados de uma transação FTP. Se a resposta demorar mais do que esse valor de tempo limite, a solicitação será cancelada. Essa opção pode ser usada em qualquer identificador HINTERNET , incluindo um identificador NULL . Ele é usado por InternetQueryOption e InternetSetOption.

Esse sinalizador não tem impacto na funcionalidade HTTP.

INTERNET_OPTION_DATA_SEND_TIMEOUT

7

Define ou recupera um valor inteiro longo sem sinal, em milissegundos, que contém o valor de tempo limite para enviar uma solicitação para o canal de dados de uma transação FTP. Se o envio demorar mais do que esse valor de tempo limite, o envio será cancelado. Essa opção pode ser usada em qualquer identificador HINTERNET , incluindo um identificador NULL . Ele é usado por InternetQueryOption e InternetSetOption.

Esse sinalizador não tem impacto na funcionalidade HTTP.

INTERNET_OPTION_DATAFILE_NAME

33

Recupera um valor de cadeia de caracteres que contém o nome do arquivo que está fazendo backup de uma entidade baixada. Esse sinalizador é válido após a conclusão de InternetOpenUrl, FtpOpenFile, GopherOpenFile ou HttpOpenRequest . Essa opção só pode ser consultada por InternetQueryOption.

INTERNET_OPTION_DATAFILE_EXT

96

Define um valor de cadeia de caracteres que contém a extensão do arquivo que está fazendo backup de uma entidade baixada. Esse sinalizador deve ser definido antes de chamar InternetOpenUrl, FtpOpenFile, GopherOpenFile ou HttpOpenRequest. Essa opção só pode ser definida por InternetSetOption.

INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO

67

Recupera uma estrutura de INTERNET_DIAGNOSTIC_SOCKET_INFO que contém dados sobre uma solicitação HTTP especificada. Esse sinalizador é usado por InternetQueryOption.

Windows 7: Não há mais suporte para essa opção.

INTERNET_OPTION_DIGEST_AUTH_UNLOAD

76

Faz com que o sistema faça logoff do pacote SSPI de autenticação digest, limpando todas as credenciais criadas para o processo. Nenhum buffer é necessário para essa opção. Ele é usado por InternetSetOption.

INTERNET_OPTION_DISABLE_AUTODIAL

70

Não implementado.

INTERNET_OPTION_DISCONNECTED_TIMEOUT

49

Não implementado.

INTERNET_OPTION_ENABLE_HTTP_PROTOCOL

148

Define uma máscara de bits DWORD de versões HTTP avançadas aceitáveis. Pode ser definido em qualquer tipo de identificador. Os valores possíveis são:

• HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Com suporte no Windows 10, versão 1507 e posterior.

As versões herdadas do HTTP (1.1 e anterior) não podem ser desabilitadas usando essa opção. O padrão é 0x0. Com suporte em Windows 10, versão 1507 e posterior.

INTERNET_OPTION_ENABLE_REDIRECT_CACHE_READ

122

Em um identificador de solicitação, define um booliano que controla se os redirecionamentos serão retornados do cache WinInet para uma determinada solicitação. O padrão é FALSE. Com suporte em Windows 8 e posteriores.

INTERNET_OPTION_ENCODE_EXTRA

155

Obtém/define um BOOL que indica se caracteres não ASCII na cadeia de caracteres de consulta devem ser codificados por porcentagem. O padrão é FALSE. Com suporte em Windows 8.1 e posteriores.

INTERNET_OPTION_END_BROWSER_SESSION

42

Libera entradas não em uso do cache de senha na unidade de disco rígido. Também redefine o tempo de cache usado quando o modo de sincronização é uma vez por sessão. Nenhum buffer é necessário para essa opção. Isso é usado por InternetSetOption.

INTERNET_OPTION_ERROR_MASK

62

Define um valor inteiro longo sem sinal que contém as máscaras de erro que podem ser manipuladas pelo aplicativo cliente. Isso pode ser uma combinação dos seguintes valores:

INTERNET_ERROR_MASK_COMBINED_SEC_CERT

0x2

Indica que todos os erros de certificado devem ser relatados usando o mesmo retorno de erro, ou seja, ERROR_INTERNET_SEC_CERT_ERRORS. Se esse sinalizador estiver definido, chame InternetErrorDlg ao receber o erro ERROR_INTERNET_SEC_CERT_ERRORS para que o usuário possa responder a uma caixa de diálogo familiar que descreve o problema.

Cuidado

Falha ao informar o usuário sobre esse erro expõe o usuário a possíveis ataques de falsificação.

INTERNET_ERROR_MASK_INSERT_CDROM

0x1

Indica que o aplicativo cliente pode lidar com o código de erro ERROR_INTERNET_INSERT_CDROM .

INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY

0x8

Indica que o aplicativo cliente pode lidar com o código de erro ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY .

INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG

0x4

Não implementado.

INTERNET_OPTION_ENTERPRISE_CONTEXT

159

Define um PWSTR que contém a ID da Empresa (consulte https://msdn.microsoft.com/library/windows/desktop/mt759320(v=vs.85).aspx) que se aplica à solicitação. Com suporte em Windows 10, versão 1507 e posterior.

INTERNET_OPTION_EXTENDED_ERROR

24

Recupera um valor inteiro longo sem sinal que contém um código de erro Winsock mapeado para o ERROR_INTERNET_ mensagens de erro retornadas pela última vez neste contexto de thread. Essa opção é usada em um identificador HINTERNET NULL por InternetQueryOption.

INTERNET_OPTION_FROM_CACHE_TIMEOUT

63

Define ou recupera um valor inteiro longo sem sinal de 1n que contém a quantidade de tempo que o sistema deve aguardar uma resposta a uma solicitação de rede antes de verificar o cache para obter uma cópia do recurso. Se uma solicitação de rede demorar mais do que o tempo especificado e o recurso solicitado estiver disponível no cache, o recurso será recuperado do cache. Isso é usado por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_HANDLE_TYPE

9

Recupera um valor inteiro longo sem sinal que contém o tipo dos identificadores HINTERNET passados. Isso é usado por InternetQueryOption em qualquer identificador HINTERNET . Os possíveis valores retornados incluem o seguinte.

INTERNET_HANDLE_TYPE_CONNECT_FTP

2

INTERNET_HANDLE_TYPE_CONNECT_GOPHER

3

INTERNET_HANDLE_TYPE_CONNECT_HTTP

4

INTERNET_HANDLE_TYPE_FILE_REQUEST

14

INTERNET_HANDLE_TYPE_FTP_FILE

7

INTERNET_HANDLE_TYPE_FTP_FILE_HTML

8

INTERNET_HANDLE_TYPE_FTP_FIND

5

INTERNET_HANDLE_TYPE_FTP_FIND_HTML

6

INTERNET_HANDLE_TYPE_GOPHER_FILE

11

INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML

12

INTERNET_HANDLE_TYPE_GOPHER_FIND

9

INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML

10

INTERNET_HANDLE_TYPE_HTTP_REQUEST

13

INTERNET_HANDLE_TYPE_INTERNET

1

INTERNET_OPTION_HSTS

157

Obtém/define um BOOL que indica se o WinInet deve seguir as diretivas http strict transport security (HSTS) dos servidores. Se habilitado, https:// solicitações esquematizados para domínios que têm uma política HSTS armazenada em cache pelo WinInet serão redirecionadas para urls de https:// correspondentes. O padrão é FALSE. Com suporte em Windows 8.1 e posteriores.

INTERNET_OPTION_HTTP_DECODING

65

Permite que o WinINet execute a decodificação para os esquemas de codificação gzip e deflate. Para obter mais informações, consulte Codificação de conteúdo.

INTERNET_OPTION_HTTP_PROTOCOL_USED

149

Obtém um DWORD que indica qual versão HTTP avançada foi usada em uma determinada solicitação. Os valores possíveis são:

• HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Com suporte no Windows 10, versão 1507 e posterior.

0x0 indica HTTP/1.1 ou anterior; consulte INTERNET_OPTION_HTTP_VERSION se for necessário mais precisão sobre qual versão herdada foi usada. Com suporte no Windows 10, versão 1507 e posterior.

INTERNET_OPTION_HTTP_VERSION

59

Define ou recupera uma estrutura HTTP_VERSION_INFO que contém a versão HTTP com suporte. Isso deve ser usado em um identificador NULL . Isso é usado por InternetQueryOption e InternetSetOption.

No Windows 7, Windows Server 2008 R2 e posterior, o valor do membro dwMinorVersion na estrutura HTTP_VERSION_INFO é substituído pelas configurações de Explorer da Internet. EnableHttp1_1 é um valor de registro em HKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE controlado pelas Opções de Internet definidas na Internet Explorer para o sistema. O valor de EnableHttp1_1 padrão é 1. A estrutura HTTP_VERSION_INFO será ignorada para qualquer versão HTTP menor que 1.1 se EnableHttp1_1 estiver definido como 1.

INTERNET_OPTION_IDENTITY

78

Não implementado.

INTERNET_OPTION_IDLE_STATE

51

Não implementado.

INTERNET_OPTION_IDN

102

Por padrão, a parte de host ou autoridade da URL é codificada de acordo com a especificação de IDN para conexões diretas e proxy. Essa opção pode ser usada na solicitação ou no identificador de conexão para habilitar ou desabilitar o IDN. Quando o IDN está desabilitado, o WinINet usa a página de código do sistema para codificar a parte de host ou autoridade da URL. Para desabilitar a conversão de host IDN, defina o parâmetro lpBuffer na chamada como InternetSetOption como zero. Para habilitar a conversão de IDN apenas na conexão direta, especifique INTERNET_FLAG_IDN_DIRECT no parâmetro lpBuffer na chamada para InternetSetOption. Para habilitar a conversão de IDN apenas na conexão de proxy, especifique INTERNET_FLAG_IDN_PROXY no parâmetro lpBuffer na chamada para InternetSetOption.

Windows XP com SP2 e Windows Server 2003 com SP1: Não há suporte para esse sinalizador.

Versão: Requer a Internet Explorer 7.0.

INTERNET_OPTION_IGNORE_OFFLINE

77

Define ou recupera se o sinalizador offline global deve ser ignorado para o identificador de solicitação especificado. Nenhum buffer é necessário para essa opção. Isso é usado por InternetQueryOption e InternetSetOption com um identificador de solicitação. Essa opção só é válida na Internet Explorer 5 e posteriores.

INTERNET_OPTION_KEEP_CONNECTION

22

Não implementado.

INTERNET_OPTION_LISTEN_TIMEOUT

11

Não implementado.

INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER

74

Define ou recupera um valor inteiro longo sem sinal que contém o número máximo de conexões permitidas por servidor HTTP/1.0. Isso é usado por InternetQueryOption e InternetSetOption. Essa opção só é válida na Internet Explorer 5 e posteriores.

INTERNET_OPTION_MAX_CONNS_PER_PROXY

103

Define ou recupera um valor inteiro longo sem sinal que contém o número máximo de conexões permitidas por proxy CERN. Quando essa opção é definida ou recuperada, o parâmetro hInternet deve definir como um valor de identificador nulo . Um valor de identificador nulo indica que a opção deve ser definida ou consultada para o processo atual. Ao chamar InternetSetOption com essa opção, todos os objetos proxy existentes receberão o novo valor. Esse valor é limitado a um intervalo de 2 a 128, inclusive.

Versão: Requer a Internet Explorer 8.0.

INTERNET_OPTION_MAX_CONNS_PER_SERVER

73

Define ou recupera um valor inteiro longo sem sinal que contém o número máximo de conexões permitidas por servidor. Isso é usado por InternetQueryOption e InternetSetOption. Essa opção só é válida na Internet Explorer 5 e posteriores.

INTERNET_OPTION_OFFLINE_MODE

26

Não implementado.

INTERNET_OPTION_OFFLINE_SEMANTICS

52

Não implementado.

INTERNET_OPTION_OPT_IN_WEAK_SIGNATURE

176

Aceitar assinaturas fracas (por exemplo, SHA-1) a serem tratadas como inseguras. Isso instruirá o WinInet a chamar CertGetCertificateChain usando o parâmetro CERT_CHAIN_OPT_IN_WEAK_SIGNATURE .

INTERNET_OPTION_PARENT_HANDLE

21

Recupera o identificador pai para esse identificador. Essa opção pode ser usada em qualquer identificador HINTERNET por InternetQueryOption.

INTERNET_OPTION_PASSWORD

29

Define ou recupera um valor de cadeia de caracteres que contém a senha associada a um identificador retornado pelo InternetConnect. Isso é usado por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_PER_CONNECTION_OPTION

75

Define ou recupera uma estrutura INTERNET_PER_CONN_OPTION_LIST que especifica uma lista de opções para uma conexão específica. Isso é usado por InternetQueryOption e InternetSetOption. Essa opção só é válida na Internet Explorer 5 e posteriores.

Observação

INTERNET_OPTION_PER_CONNECTION_OPTION faz com que as configurações sejam alteradas em todo o sistema quando um identificador NULL é usado na chamada para InternetSetOption. Para atualizar as configurações de proxy global, você deve chamar InternetSetOption com o sinalizador de opção INTERNET_OPTION_REFRESH .

Observação

Para alterar as informações de proxy para todo o processo sem afetar as configurações globais na Internet Explorer 5 e posteriores, use essa opção no identificador retornado de InternetOpen. O exemplo de código a seguir altera o proxy para todo o processo, embora o identificador HINTERNET esteja fechado e não seja usado por nenhuma solicitação.

INTERNET_OPTION_POLICY

48

Não implementado.

INTERNET_OPTION_PROXY

38

Define ou recupera uma estrutura INTERNET_PROXY_INFO que contém os dados de proxy para um identificador InternetOpen existente quando o identificador HINTERNET não é NULL. Se o identificador HINTERNET for NULL, a função definirá ou consultará os dados de proxy global. Essa opção pode ser usada no identificador retornado por InternetOpen. Ele é usado por InternetQueryOption e InternetSetOption.

Observação

É recomendável que INTERNET_OPTION_PER_CONNECTION_OPTION sejam usados em vez de INTERNET_OPTION_PROXY.

INTERNET_OPTION_PROXY_PASSWORD

44

Define ou recupera um valor de cadeia de caracteres que contém a senha usada para acessar o proxy. Isso é usado por InternetQueryOption e InternetSetOption. Essa opção pode ser definida no identificador retornado por InternetConnect ou HttpOpenRequest.

INTERNET_OPTION_PROXY_SETTINGS_CHANGED

95

Alerta a instância atual do WinInet de que as configurações de proxy foram alteradas e que elas devem ser atualizadas com as novas configurações. Para alertar todas as instâncias wininet disponíveis, defina o parâmetro Buffer de InternetSetOption como NULL e BufferLength como 0 ao passar essa opção. Essa opção pode ser definida no identificador retornado por InternetConnect ou HttpOpenRequest.

INTERNET_OPTION_PROXY_USERNAME

43

Define ou recupera um valor de cadeia de caracteres que contém o nome de usuário usado para acessar o proxy. Isso é usado por InternetQueryOption e InternetSetOption. Essa opção pode ser definida no identificador retornado por InternetConnect ou HttpOpenRequest.

INTERNET_OPTION_READ_BUFFER_SIZE

12

Define ou recupera um valor inteiro longo sem sinal que contém o tamanho do buffer de leitura. Essa opção pode ser usada em identificadores HINTERNET retornados por FtpOpenFile, FtpFindFirstFile e InternetConnect (somente sessão FTP). Essa opção é usada por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_RECEIVE_THROUGHPUT

57

Não implementado.

INTERNET_OPTION_RECEIVE_TIMEOUT

6

Define ou recupera um valor inteiro longo sem sinal que contém o valor de tempo limite, em milissegundos, para receber uma resposta a uma solicitação. Se a resposta demorar mais do que esse valor de tempo limite, a solicitação será cancelada. Essa opção pode ser usada em qualquer identificador HINTERNET , incluindo um identificador NULL . Ele é usado por InternetQueryOption e InternetSetOption.

Essa opção não se destina a representar um tempo limite imediato refinado. Você pode esperar que o tempo limite ocorra até seis segundos após o valor de tempo limite definido.

Quando usada em referência a uma transação FTP, essa opção se refere ao canal de controle.

INTERNET_OPTION_REFRESH

37

Faz com que os dados de proxy sejam relêdos do registro para um identificador. Nenhum buffer é necessário. Essa opção pode ser usada no identificador HINTERNET retornado por InternetOpen. Ele é usado por InternetSetOption.

INTERNET_OPTION_REMOVE_IDENTITY

79

Não implementado.

INTERNET_OPTION_REQUEST_FLAGS

23

Recupera um valor inteiro longo sem sinal que contém os sinalizadores de status especiais que indicam o status do download em andamento. Isso é usado por InternetQueryOption. A opção INTERNET_OPTION_REQUEST_FLAGS pode ser um dos seguintes valores:

INTERNET_REQFLAG_ASYNC

0x00000002

Não implementado.

INTERNET_REQFLAG_CACHE_WRITE_DISABLED

0x00000040

A solicitação da Internet não pode ser armazenada em cache (uma solicitação HTTPS, por exemplo).

INTERNET_REQFLAG_FROM_CACHE

0x00000001

A resposta veio do cache.

INTERNET_REQFLAG_NET_TIMEOUT

0x00000080

A solicitação da Internet atingiu o tempo limite.

INTERNET_REQFLAG_NO_HEADERS

0x00000008

A resposta original não continha cabeçalhos.

INTERNET_REQFLAG_PASSIVE

0x00000010

Não implementado.

INTERNET_REQFLAG_VIA_PROXY

0x00000004

A solicitação foi feita por meio de um proxy.

INTERNET_OPTION_REQUEST_PRIORITY

58

Define ou recupera um valor inteiro longo sem sinal que contém a prioridade das solicitações que competem por uma conexão em um identificador HTTP. Isso é usado por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_RESET_URLCACHE_SESSION

60

Inicia uma nova sessão de cache para o processo. Nenhum buffer é necessário. Isso é usado por InternetSetOption. Essa opção é reservada apenas para uso interno.

INTERNET_OPTION_SECONDARY_CACHE_KEY

53

Define ou recupera um valor de cadeia de caracteres que contém a chave de cache secundária. Isso é usado por InternetQueryOption e InternetSetOption. Essa opção é reservada apenas para uso interno.

INTERNET_OPTION_SECURITY_CERTIFICATE

35

Recupera o certificado de um servidor SSL/PCT (Secure Sockets Layer/Private Communications Technology) em uma cadeia de caracteres formatada. Isso é usado por InternetQueryOption.

INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT

32

Recupera o certificado de um servidor SSL/PCT na estrutura INTERNET_CERTIFICATE_INFO. Isso é usado por InternetQueryOption.

INTERNET_OPTION_SECURITY_FLAGS

31

Recupera um valor inteiro longo sem sinal que contém os sinalizadores de segurança de um identificador. Essa opção é usada por InternetQueryOption. Pode ser uma combinação dos seguintes valores.

SECURITY_FLAG_128BIT

0x20000000

Idêntico ao valor preferencial SECURITY_FLAG_STRENGTH_STRONG. Isso só é retornado em uma chamada para InternetQueryOption.

SECURITY_FLAG_40BIT

0x10000000

Idêntico ao valor preferencial SECURITY_FLAG_STRENGTH_WEAK. Isso só é retornado em uma chamada para InternetQueryOption.

SECURITY_FLAG_56BIT

0x40000000

Idêntico ao valor preferencial SECURITY_FLAG_STRENGTH_MEDIUM. Isso só é retornado em uma chamada para InternetQueryOption.

SECURITY_FLAG_FORTEZZA

0x08000000

Indica que o Fortezza foi usado para fornecer sigilo, autenticação e/ou integridade para a conexão especificada.

SECURITY_FLAG_IETFSSL4

0x00000020

Não implementado.

SECURITY_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

Ignora a mensagem de erro ERROR_INTERNET_SEC_CERT_CN_INVALID .

SECURITY_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

Ignora a mensagem de erro ERROR_INTERNET_SEC_CERT_DATE_INVALID .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

Ignora a mensagem de erro ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

Ignora a mensagem de erro ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR .

SECURITY_FLAG_IGNORE_REVOCATION

0x00000080

Ignora problemas de revogação de certificado.

SECURITY_FLAG_IGNORE_UNKNOWN_CA

0x00000100

Ignora problemas de autoridade de certificação desconhecidos.

SECURITY_FLAG_IGNORE_WEAK_SIGNATURE

0x00010000

Ignora problemas fracos de assinatura de certificado.

SECURITY_FLAG_IGNORE_WRONG_USAGE

0x00000200

Ignora problemas de uso incorretos.

SECURITY_FLAG_NORMALBITNESS

0x10000000

Idêntico ao valor SECURITY_FLAG_STRENGTH_WEAK. Isso só é retornado em uma chamada para InternetQueryOption.

SECURITY_FLAG_PCT

0x00000008

Não implementado.

SECURITY_FLAG_PCT4

0x00000010

Não implementado.

SECURITY_FLAG_SECURE

0x00000001

Usa transferências seguras. Isso só é retornado em uma chamada para InternetQueryOption.

SECURITY_FLAG_SSL

0x00000002

Não implementado.

SECURITY_FLAG_SSL3

0x00000004

Não implementado.

SECURITY_FLAG_STRENGTH_MEDIUM

0x40000000

Usa criptografia média (56 bits). Isso só é retornado em uma chamada para InternetQueryOption.

SECURITY_FLAG_STRENGTH_STRONG

0x20000000

Usa criptografia forte (128 bits). Isso só é retornado em uma chamada para InternetQueryOption.

SECURITY_FLAG_STRENGTH_WEAK

0x10000000

Usa criptografia fraca (40 bits). Isso só é retornado em uma chamada para InternetQueryOption.

SECURITY_FLAG_UNKNOWNBIT

0x80000000

O tamanho do bit usado na criptografia é desconhecido. Isso só é retornado em uma chamada para InternetQueryOption.

Lembre-se de que os dados recuperados dessa forma estão relacionados a uma transação que ocorreu, cujo nível de segurança não pode mais ser alterado.

INTERNET_OPTION_SECURITY_KEY_BITNESS

36

Recupera um valor inteiro longo sem sinal que contém o tamanho do bit da chave de criptografia. Quanto maior o número, maior a força de criptografia usada. Isso é usado por InternetQueryOption. Lembre-se de que os dados recuperados dessa forma estão relacionados a uma transação que já ocorreu, cujo nível de segurança não pode mais ser alterado.

INTERNET_OPTION_SEND_THROUGHPUT

56

Não implementado.

INTERNET_OPTION_SEND_TIMEOUT

5

Define ou recupera um valor inteiro longo sem sinal, em milissegundos, que contém o valor de tempo limite para enviar uma solicitação. Se o envio demorar mais do que esse valor de tempo limite, o envio será cancelado. Essa opção pode ser usada em qualquer identificador HINTERNET , incluindo um identificador NULL . Ele é usado por InternetQueryOption e InternetSetOption.

Quando usada em referência a uma transação FTP, essa opção se refere ao canal de controle.

INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT

105

Recupera o contexto de cadeia de certificados do servidor como uma PCCERT_CHAIN_CONTEXT duplicada. Você pode passar esse contexto duplicado para qualquer função de API de Criptografia que usa um PCCERT_CHAIN_CONTEXT. Você deve chamar CertFreeCertificateChain no PCCERT_CHAIN_CONTEXT retornado quando terminar o contexto de cadeia de certificados.

Versão: Requer a Internet Explorer 8.0.

INTERNET_OPTION_SETTINGS_CHANGED

39

Notifica o sistema de que as configurações do Registro foram alteradas para que ele verifique as configurações na próxima chamada para InternetConnect. Isso é usado por InternetSetOption.

INTERNET_OPTION_SUPPRESS_SERVER_AUTH

104

Define um objeto de solicitação HTTP de modo que ele não faça logon em servidores de origem, mas executará logon automático em servidores proxy HTTP. Essa opção difere do sinalizador de solicitação INTERNET_FLAG_NO_AUTH, o que impede a autenticação para servidores proxy e servidores de origem.

Definir esse modo suprimirá o uso de qualquer material de credencial (nome de usuário/senha fornecido anteriormente ou certificado SSL do cliente) ao se comunicar com um servidor de origem. No entanto, se a solicitação precisar transitar por meio de um proxy de autenticação, o WinINet ainda executará a autenticação automática para o proxy HTTP de acordo com as configurações da Zona da Intranet para o usuário. A configuração padrão da Zona da Intranet é permitir o logon automático usando as credenciais padrão do usuário.

Para garantir a supressão de todas as informações de identificação, o chamador deve combinar INTERNET_OPTION_SUPPRESS_SERVER_AUTH com o sinalizador de solicitação INTERNET_FLAG_NO_COOKIES.

Essa opção só pode ser definida em objetos de solicitação antes de serem enviados. As tentativas de definir essa opção após o envio da solicitação retornarão ERROR_INTERNET_INCORRECT_HANDLE_STATE.

Nenhum buffer é necessário para essa opção. Isso é usado por InternetSetOption em identificadores retornados apenas por HttpOpenRequest .

Versão: Requer a Internet Explorer 8.0 ou posterior.

INTERNET_OPTION_SUPPRESS_BEHAVIOR

81

Uma opção de finalidade geral usada para suprimir comportamentos em todo o processo. O parâmetro lpBuffer da função deve ser um ponteiro para um DWORD que contenha o comportamento específico a ser suprimido. Essa opção não pode ser consultada com InternetQueryOption. Os valores permitidos são:

INTERNET_SUPPRESS_RESET_ALL

0

Desabilita todas as supressões, reabilitando o comportamento padrão e configurado. Essa opção é equivalente à configuração INTERNET_SUPPRESS_COOKIE_POLICY_RESET e INTERNET_SUPPRESS_COOKIE_PERSIST_RESET individualmente.

Versão: Requer a Internet Explorer 6.0 ou posterior.

INTERNET_SUPPRESS_COOKIE_POLICY

1

Ignora as políticas de cookie configuradas e permite que os cookies sejam definidos.

Versão: Requer a Internet Explorer 6.0 ou posterior.

INTERNET_SUPPRESS_COOKIE_POLICY_RESET

2

Desabilita a supressão INTERNET_SUPPRESS_COOKIE_POLICY , permitindo a avaliação de cookies de acordo com a política de cookie configurada.

Versão: Requer a Internet Explorer 6.0 ou posterior.

INTERNET_SUPPRESS_COOKIE_PERSIST

3

Suprime a persistência de cookies, mesmo que o servidor os tenha especificado como persistentes.

Versão: Requer a Internet Explorer 8.0 ou posterior.

INTERNET_SUPPRESS_COOKIE_PERSIST_RESET

4

Desabilita a supressão INTERNET_SUPPRESS_COOKIE_PERSIST , reabilitando a persistência de cookies. Os cookies suprimidos anteriormente não se tornarão persistentes.

Versão: Requer a Internet Explorer 8.0 ou posterior.

INTERNET_OPTION_URL

34

Recupera um valor de cadeia de caracteres que contém a URL completa de um recurso baixado. Se a URL original contiver dados extras, como cadeias de caracteres de pesquisa ou âncoras, ou se a chamada tiver sido redirecionada, a URL retornada será diferente da original. Essa opção é válida em identificadores HINTERNET retornados por InternetOpenUrl, FtpOpenFile, GopherOpenFile ou HttpOpenRequest. Ele é usado por InternetQueryOption.

INTERNET_OPTION_USER_AGENT

41

Define ou recupera a cadeia de caracteres do agente do usuário em identificadores fornecidos pela InternetOpen e usados em funções HttpSendRequest subsequentes, desde que ela não seja substituída por um cabeçalho adicionado por HttpAddRequestHeaders ou HttpSendRequest. Isso é usado por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_USERNAME

28

Define ou recupera uma cadeia de caracteres que contém o nome de usuário associado a um identificador retornado pelo InternetConnect. Isso é usado por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_VERSION

40

Recupera uma estrutura de INTERNET_VERSION_INFO que contém o número de versão de Wininet.dll. Essa opção pode ser usada em um identificador HINTERNET NULL por InternetQueryOption.

INTERNET_OPTION_WRITE_BUFFER_SIZE

13

Define ou recupera um valor inteiro longo sem sinal que contém o tamanho, em bytes, do buffer de gravação. Essa opção pode ser usada em identificadores HINTERNET retornados por FtpOpenFile e InternetConnect (somente sessão FTP). Ele é usado por InternetQueryOption e InternetSetOption.

Comentários

Observação

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

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; Winineti.h