Sinalizadores de API

Muitas das funções WinINet aceitam uma matriz de sinalizadores como um parâmetro. Veja a seguir uma breve descrição dos sinalizadores definidos.

INTERNET_COOKIE_EVALUATE_P3P

0x80

Indica que um cabeçalho P3P (Plataforma de Proteção à Privacidade) deve ser associado a um cookie.

INTERNET_COOKIE_THIRD_PARTY

0x10

Indica que um cookie de terceiros está sendo definido ou recuperado.

INTERNET_FLAG_ASYNC

0x10000000

Faz apenas solicitações assíncronas em identificadores descendentes do identificador retornado dessa função. Somente a função InternetOpen usa esse sinalizador.

INTERNET_FLAG_CACHE_ASYNC

0x00000080

Permite uma gravação de cache lenta.

INTERNET_FLAG_CACHE_IF_NET_FAIL

0x00010000

Retorna o recurso do cache se a solicitação de rede para o recurso falhar devido a um erro de ERROR_INTERNET_CONNECTION_RESET ou ERROR_INTERNET_CANNOT_CONNECT . Esse sinalizador é usado por HttpOpenRequest.

INTERNET_FLAG_DONT_CACHE

0x04000000

Não adiciona a entidade retornada ao cache. Isso é idêntico ao valor preferencial, INTERNET_FLAG_NO_CACHE_WRITE.

INTERNET_FLAG_EXISTING_CONNECT

0x20000000

Tenta usar um objeto InternetConnect existente se houver um com os mesmos atributos necessários para fazer a solicitação. Isso é útil apenas com operações FTP, pois o FTP é o único protocolo que normalmente executa várias operações durante a mesma sessão. O WinINet armazena em cache um único identificador de conexão para cada identificador HINTERNET gerado pela InternetOpen. As funções InternetOpenUrl e InternetConnect usam esse sinalizador para conexões Http e Ftp.

INTERNET_FLAG_FORMS_SUBMIT

0x00000040

Indica que este é um envio de Formulários.

INTERNET_FLAG_FROM_CACHE

0x01000000

Não faz solicitações de rede. Todas as entidades são retornadas do cache. Se o item solicitado não estiver no cache, um erro adequado, como ERROR_FILE_NOT_FOUND, será retornado. Somente a função InternetOpen usa esse sinalizador.

INTERNET_FLAG_FWD_BACK

0x00000020

Indica que a função deve usar a cópia do recurso que está atualmente no cache da Internet. A data de validade e outras informações sobre o recurso não estão marcadas. Se o item solicitado não for encontrado no cache da Internet, o sistema tentará localizar o recurso na rede. Esse valor foi introduzido no Microsoft Internet Explorer 5 e está associado às operações de botão Avançar e Voltar do Explorer internet.

INTERNET_FLAG_HYPERLINK

0x00000400

Força um recarregamento se não houver tempo expirado e nenhum tempo LastModified retornado do servidor ao determinar se o item deve ser recarregado da rede. Esse sinalizador pode ser usado por FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl.

Windows XP e Windows Server 2003 R2 e versões anteriores: Também usado por GopherFindFirstFile e GopherOpenFile.

INTERNET_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

Desabilita a verificação de certificados baseados em SSL/PCT que são retornados do servidor em relação ao nome do host fornecido na solicitação. O WinINet usa uma marcar simples em relação a certificados comparando nomes de host correspondentes e regras de curinga simples. Esse sinalizador pode ser usado por HttpOpenRequest e InternetOpenUrl (para solicitações HTTP).

INTERNET_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

Desabilita a verificação de certificados baseados em SSL/PCT para datas de validade adequadas. Esse sinalizador pode ser usado por HttpOpenRequest e InternetOpenUrl (para solicitações HTTP).

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

Desabilita a detecção desse tipo especial de redirecionamento. Quando esse sinalizador é usado, o WinINet permite redirecionamentos de HTTPS para URLs HTTP de forma transparente. Esse sinalizador pode ser usado por HttpOpenRequest e InternetOpenUrl (para solicitações HTTP).

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

Desabilita a detecção desse tipo especial de redirecionamento. Quando esse sinalizador é usado, a WinINet permite redirecionamentos de HTTP para URLs HTTPS de forma transparente. Esse sinalizador pode ser usado por HttpOpenRequest e InternetOpenUrl (para solicitações HTTP).

INTERNET_FLAG_KEEP_CONNECTION

0x00400000

Usa semântica keep alive, se disponível, para a conexão. Esse sinalizador é usado por HttpOpenRequest e InternetOpenUrl (para solicitações HTTP). Esse sinalizador é necessário para MSN (Microsoft Network), NTLM e outros tipos de autenticação.

INTERNET_FLAG_MAKE_PERSISTENT

0x02000000

Não tem mais suporte.

INTERNET_FLAG_MUST_CACHE_REQUEST

0x00000010

Idêntico ao valor preferencial, INTERNET_FLAG_NEED_FILE. Faz com que um arquivo temporário seja criado se o arquivo não puder ser armazenado em cache. Esse sinalizador pode ser usado por FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl.

Windows XP e Windows Server 2003 R2 e versões anteriores: Também usado por GopherFindFirstFile e GopherOpenFile.

INTERNET_FLAG_NEED_FILE

0x00000010

Faz com que um arquivo temporário seja criado se o arquivo não puder ser armazenado em cache. Esse sinalizador pode ser usado por FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl.

Windows XP e Windows Server 2003 R2 e versões anteriores: Também usado por GopherFindFirstFile e GopherOpenFile.

INTERNET_FLAG_NO_AUTH

0x00040000

Não tenta a autenticação automaticamente. Esse sinalizador pode ser usado por HttpOpenRequest e InternetOpenUrl (para solicitações HTTP).

INTERNET_FLAG_NO_AUTO_REDIRECT

0x00200000

Não manipula automaticamente o redirecionamento em HttpSendRequest. Esse sinalizador também pode ser usado por InternetOpenUrl para solicitações HTTP.

INTERNET_FLAG_NO_CACHE_WRITE

0x04000000

Não adiciona a entidade retornada ao cache. Esse sinalizador é usado por , HttpOpenRequest e InternetOpenUrl.

Windows XP e Windows Server 2003 R2 e versões anteriores: Também usado por GopherFindFirstFile e GopherOpenFile.

INTERNET_FLAG_NO_COOKIES

0x00080000

Não adiciona automaticamente cabeçalhos de cookie a solicitações e não adiciona automaticamente cookies retornados ao banco de dados de cookie. Esse sinalizador pode ser usado por HttpOpenRequest e InternetOpenUrl (para solicitações HTTP).

INTERNET_FLAG_NO_UI

0x00000200

Desabilita a caixa de diálogo de cookie. Esse sinalizador pode ser usado por HttpOpenRequest e InternetOpenUrl (somente solicitações HTTP).

INTERNET_FLAG_OFFLINE

0x01000000

Idêntico a INTERNET_FLAG_FROM_CACHE. Não faz solicitações de rede. Todas as entidades são retornadas do cache. Se o item solicitado não estiver no cache, um erro adequado, como ERROR_FILE_NOT_FOUND, será retornado. Somente a função InternetOpen usa esse sinalizador.

INTERNET_FLAG_PASSIVE

0x08000000

Usa semântica FTP passiva. Somente InternetConnect e InternetOpenUrl usam esse sinalizador. O InternetConnect usa esse sinalizador para solicitações FTP, e InternetOpenUrl usa esse sinalizador para arquivos e diretórios FTP.

INTERNET_FLAG_PRAGMA_NOCACHE

0x00000100

Força a solicitação a ser resolvida pelo servidor de origem, mesmo que exista uma cópia armazenada em cache no proxy. A função InternetOpenUrl (somente em solicitações HTTP e HTTPS) e a função HttpOpenRequest usam esse sinalizador.

INTERNET_FLAG_RAW_DATA

0x40000000

Retorna os dados como uma estrutura WIN32_FIND_DATA ao recuperar informações de diretório FTP. Se esse sinalizador não for especificado ou se a chamada for feita por meio de um proxy CERN, InternetOpenUrl retornará a versão HTML do diretório. Somente a função InternetOpenUrl usa esse sinalizador.

Windows XP e Windows Server 2003 R2 e versões anteriores: Também retorna uma estrutura GOPHER_FIND_DATA ao recuperar informações do diretório Gopher.

INTERNET_FLAG_READ_PREFETCH

0x00100000

Esse sinalizador está desabilitado no momento.

INTERNET_FLAG_RELOAD

0x80000000

Força um download do arquivo, objeto ou listagem de diretório solicitado do servidor de origem, não do cache. As funções FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl usam esse sinalizador.

Windows XP e Windows Server 2003 R2 e versões anteriores: Também usado por GopherFindFirstFile e GopherOpenFile.

INTERNET_FLAG_RESTRICTED_ZONE

0x00020000

Indica que o cookie que está sendo definido está associado a um site não confiável.

INTERNET_FLAG_RESYNCHRONIZE

0x00000800

Recarrega recursos HTTP se o recurso tiver sido modificado desde a última vez em que foi baixado. Todos os recursos de FTP são recarregados. Esse sinalizador pode ser usado por FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl.

Windows XP e Windows Server 2003 R2 e versões anteriores: Também são recarregados os recursos GopherFindFirstFile e GopherOpenFile e Gopher.

INTERNET_FLAG_SECURE

0x00800000

Usa semântica de transação segura. Isso se traduz no uso da SSL/PCT (Secure Sockets Layer/Private Communications Technology) e só é significativo em solicitações HTTP. Esse sinalizador é usado por HttpOpenRequest e InternetOpenUrl, mas isso será redundante se https:// aparecer na URL. A função InternetConnect usa esse sinalizador para conexões HTTP; todos os identificadores de solicitação criados nessa conexão herdarão esse sinalizador.

INTERNET_FLAG_TRANSFER_ASCII

0x00000001

Transfere o arquivo como ASCII (somente FTP). Esse sinalizador pode ser usado por FtpOpenFile, FtpGetFile e FtpPutFile.

INTERNET_FLAG_TRANSFER_BINARY

0x00000002

Transfere o arquivo como binário (somente FTP). Esse sinalizador pode ser usado por FtpOpenFile, FtpGetFile e FtpPutFile.

INTERNET_NO_CALLBACK

0x00000000

Indica que nenhum retorno de chamada deve ser feito para essa API. Isso é usado para o parâmetro dxContext das funções que permitem operações assíncronas.

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 de Zona da Intranet padrão é 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 somente em identificadores retornados por HttpOpenRequest. Versão: requer a Internet Explorer 8.0 ou posterior.

WININET_API_FLAG_ASYNC

0x00000001

Força operações assíncronas.

WININET_API_FLAG_SYNC

0x00000004

Força operações síncronas.

WININET_API_FLAG_USE_CONTEXT

0x00000008

Força a API a usar o valor de contexto, mesmo que ela esteja definida como zero.

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