Flag API

Molte delle funzioni WinINet accettano una matrice di flag come parametro. Di seguito è riportata una breve descrizione dei flag definiti.

INTERNET_COOKIE_EVALUATE_P3P

0x80

Indica che un'intestazione P3P (Platform for Privacy Protection) deve essere associata a un cookie.

INTERNET_COOKIE_THIRD_PARTY

0x10

Indica che viene impostato o recuperato un cookie di terze parti.

INTERNET_FLAG_ASYNC

0x10000000

Esegue solo richieste asincrone su handle discendenti dall'handle restituito da questa funzione. Solo la funzione InternetOpen usa questo flag.

INTERNET_FLAG_CACHE_ASYNC

0x00000080

Consente una scrittura della cache differita.

INTERNET_FLAG_CACHE_IF_NET_FAIL

0x00010000

Restituisce la risorsa dalla cache se la richiesta di rete per la risorsa ha esito negativo a causa di un errore di ERROR_INTERNET_CONNECTION_RESET o ERROR_INTERNET_CANNOT_CONNECT . Questo flag viene usato da HttpOpenRequest.

INTERNET_FLAG_DONT_CACHE

0x04000000

Non aggiunge l'entità restituita alla cache. Questo valore è identico al valore preferito , INTERNET_FLAG_NO_CACHE_WRITE.

INTERNET_FLAG_EXISTING_CONNECT

0x20000000

Tenta di utilizzare un oggetto InternetConnect esistente se ne esiste uno con gli stessi attributi necessari per effettuare la richiesta. Ciò è utile solo con le operazioni FTP, poiché FTP è l'unico protocollo che in genere esegue più operazioni durante la stessa sessione. WinINet memorizza nella cache un singolo handle di connessione per ogni handle DI RETE GESTITo da InternetOpen. Le funzioni InternetOpenUrl e InternetConnect usano questo flag per le connessioni Http e Ftp.

INTERNET_FLAG_FORMS_SUBMIT

0x00000040

Indica che si tratta di un invio di moduli.

INTERNET_FLAG_FROM_CACHE

0x01000000

Non effettua richieste di rete. Tutte le entità vengono restituite dalla cache. Se l'elemento richiesto non è presente nella cache, viene restituito un errore appropriato, ad esempio ERROR_FILE_NOT_FOUND. Solo la funzione InternetOpen usa questo flag.

INTERNET_FLAG_FWD_BACK

0x00000020

Indica che la funzione deve usare la copia della risorsa attualmente presente nella cache Internet. La data di scadenza e altre informazioni sulla risorsa non vengono controllate. Se l'elemento richiesto non viene trovato nella cache Internet, il sistema tenta di individuare la risorsa in rete. Questo valore è stato introdotto in Microsoft Internet Explorer 5 ed è associato alle operazioni del pulsante Inoltra e Indietro di Internet Explorer.

INTERNET_FLAG_HYPERLINK

0x00000400

Forza un ricaricamento se non è presente un'ora di scadenza e non viene restituito alcun tempo LastModified dal server quando si determina se ricaricare l'elemento dalla rete. Questo flag può essere usato da FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl.

Windows XP e Windows Server 2003 R2 e versioni precedenti: Usato anche da GopherFindFirstFile e GopherOpenFile.

INTERNET_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

Disabilita il controllo dei certificati basati su SSL/PCT restituiti dal server rispetto al nome host specificato nella richiesta. WinINet usa un semplice controllo sui certificati confrontando i nomi host corrispondenti e le regole di caratteri jolly semplici. Questo flag può essere usato da HttpOpenRequest e InternetOpenUrl (per le richieste HTTP).

INTERNET_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

Disabilita il controllo dei certificati basati su SSL/PCT per le date di validità appropriate. Questo flag può essere usato da HttpOpenRequest e InternetOpenUrl (per le richieste HTTP).

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

Disabilita il rilevamento di questo tipo speciale di reindirizzamento. Quando si usa questo flag, WinINet consente in modo trasparente i reindirizzamenti da HTTPS a URL HTTP. Questo flag può essere usato da HttpOpenRequest e InternetOpenUrl (per le richieste HTTP).

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

Disabilita il rilevamento di questo tipo speciale di reindirizzamento. Quando si usa questo flag, WinINet consente in modo trasparente i reindirizzamenti da HTTP a URL HTTPS. Questo flag può essere usato da HttpOpenRequest e InternetOpenUrl (per le richieste HTTP).

INTERNET_FLAG_KEEP_CONNECTION

0x00400000

Usa la semantica keep-alive, se disponibile, per la connessione. Questo flag viene usato da HttpOpenRequest e InternetOpenUrl (per le richieste HTTP). Questo flag è obbligatorio per Microsoft Network (MSN), NTLM e altri tipi di autenticazione.

INTERNET_FLAG_MAKE_PERSISTENT

0x02000000

Non più supportata.

INTERNET_FLAG_MUST_CACHE_REQUEST

0x00000010

Identico al valore preferito, INTERNET_FLAG_NEED_FILE. Determina la creazione di un file temporaneo se il file non può essere memorizzato nella cache. Questo flag può essere usato da FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl.

Windows XP e Windows Server 2003 R2 e versioni precedenti: Usato anche da GopherFindFirstFile e GopherOpenFile.

INTERNET_FLAG_NEED_FILE

0x00000010

Determina la creazione di un file temporaneo se il file non può essere memorizzato nella cache. Questo flag può essere usato da FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl.

Windows XP e Windows Server 2003 R2 e versioni precedenti: Usato anche da GopherFindFirstFile e GopherOpenFile.

INTERNET_FLAG_NO_AUTH

0x00040000

Non tenta automaticamente l'autenticazione. Questo flag può essere usato da HttpOpenRequest e InternetOpenUrl (per le richieste HTTP).

INTERNET_FLAG_NO_AUTO_REDIRECT

0x00200000

Non gestisce automaticamente il reindirizzamento in HttpSendRequest. Questo flag può essere usato anche da InternetOpenUrl per le richieste HTTP.

INTERNET_FLAG_NO_CACHE_WRITE

0x04000000

Non aggiunge l'entità restituita alla cache. Questo flag viene usato da , HttpOpenRequest e InternetOpenUrl.

Windows XP e Windows Server 2003 R2 e versioni precedenti: Usato anche da GopherFindFirstFile e GopherOpenFile.

INTERNET_FLAG_NO_COOKIES

0x00080000

Non aggiunge automaticamente intestazioni di cookie alle richieste e non aggiunge automaticamente i cookie restituiti al database dei cookie. Questo flag può essere usato da HttpOpenRequest e InternetOpenUrl (per le richieste HTTP).

INTERNET_FLAG_NO_UI

0x00000200

Disabilita la finestra di dialogo cookie. Questo flag può essere usato da HttpOpenRequest e InternetOpenUrl (solo richieste HTTP).

INTERNET_FLAG_OFFLINE

0x01000000

Identico a INTERNET_FLAG_FROM_CACHE. Non effettua richieste di rete. Tutte le entità vengono restituite dalla cache. Se l'elemento richiesto non è presente nella cache, viene restituito un errore appropriato, ad esempio ERROR_FILE_NOT_FOUND. Solo la funzione InternetOpen usa questo flag.

INTERNET_FLAG_PASSIVE

0x08000000

Usa la semantica FTP passiva. Solo InternetConnect e InternetOpenUrl usano questo flag. InternetConnect usa questo flag per le richieste FTP e InternetOpenUrl usa questo flag per file e directory FTP.

INTERNET_FLAG_PRAGMA_NOCACHE

0x00000100

Forza la richiesta a essere risolta dal server di origine, anche se esiste una copia memorizzata nella cache nel proxy. La funzione InternetOpenUrl (solo nelle richieste HTTP e HTTPS) e la funzione HttpOpenRequest usano questo flag.

INTERNET_FLAG_RAW_DATA

0x40000000

Restituisce i dati come struttura WIN32_FIND_DATA durante il recupero delle informazioni sulla directory FTP. Se questo flag non viene specificato o se la chiamata viene effettuata tramite un proxy CERN, InternetOpenUrl restituisce la versione HTML della directory. Solo la funzione InternetOpenUrl usa questo flag.

Windows XP e Windows Server 2003 R2 e versioni precedenti: Restituisce anche una struttura GOPHER_FIND_DATA durante il recupero delle informazioni sulla directory Gopher.

INTERNET_FLAG_READ_PREFETCH

0x00100000

Questo flag è attualmente disabilitato.

INTERNET_FLAG_RELOAD

0x80000000

Impone un download del file, dell'oggetto o dell'elenco di directory richiesto dal server di origine e non dalla cache. Le funzioni FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl usano questo flag.

Windows XP e Windows Server 2003 R2 e versioni precedenti: Usato anche da GopherFindFirstFile e GopherOpenFile.

INTERNET_FLAG_RESTRICTED_ZONE

0x00020000

Indica che il cookie impostato è associato a un sito non attendibile.

INTERNET_FLAG_RESYNCHRONIZE

0x00000800

Ricarica le risorse HTTP se la risorsa è stata modificata dall'ultima volta che è stata scaricata. Tutte le risorse FTP vengono ricaricate. Questo flag può essere usato da FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl.

Windows XP e Windows Server 2003 R2 e versioni precedenti: Vengono ricaricate anche le risorse GopherFindFirstFile e GopherOpenFile.

INTERNET_FLAG_SECURE

0x00800000

Utilizza semantica sicura delle transazioni. Ciò si traduce nell'uso di Secure Sockets Layer/Private Communications Technology (SSL/PCT) ed è significativo solo nelle richieste HTTP. Questo flag viene usato da HttpOpenRequest e InternetOpenUrl, ma è ridondante se https:// viene visualizzato nell'URL. La funzione InternetConnect usa questo flag per le connessioni HTTP; tutti gli handle di richiesta creati in questa connessione erediteranno questo flag.

INTERNET_FLAG_TRANSFER_ASCII

0x00000001

Trasferisce il file come ASCII (solo FTP). Questo flag può essere usato da FtpOpenFile, FtpGetFile e FtpPutFile.

INTERNET_FLAG_TRANSFER_BINARY

0x00000002

Trasferisce il file come binario (solo FTP). Questo flag può essere usato da FtpOpenFile, FtpGetFile e FtpPutFile.

INTERNET_NO_CALLBACK

0x00000000

Indica che non devono essere eseguiti callback per tale API. Viene usato per il parametro dxContext delle funzioni che consentono operazioni asincrone.

INTERNET_OPTION_SUPPRESS_SERVER_AUTH

104

Imposta un oggetto richiesta HTTP in modo che non venga eseguito l'accesso ai server di origine, ma eseguirà l'accesso automatico ai server proxy HTTP. Questa opzione è diversa dal flag richiesta INTERNET_FLAG_NO_AUTH, che impedisce l'autenticazione sia ai server proxy che ai server di origine. L'impostazione di questa modalità elimina l'uso di qualsiasi materiale delle credenziali (specificato in precedenza nome utente/password o certificato SSL client) durante la comunicazione con un server di origine. Tuttavia, se la richiesta deve transitare tramite un proxy di autenticazione, WinINet eseguirà comunque l'autenticazione automatica al proxy HTTP in base alle impostazioni dell'area Intranet per l'utente. L'impostazione predefinita dell'area Intranet consiste nel consentire l'accesso automatico usando le credenziali predefinite dell'utente. Per garantire l'eliminazione di tutte le informazioni di identificazione, il chiamante deve combinare INTERNET_OPTION_SUPPRESS_SERVER_AUTH con il flag di richiesta INTERNET_FLAG_NO_COOKIES. Questa opzione può essere impostata solo sugli oggetti richiesta prima dell'invio. I tentativi di impostare questa opzione dopo l'invio della richiesta restituiranno ERROR_INTERNET_INCORRECT_HANDLE_STATE. Per questa opzione non è necessario alcun buffer. Viene usato solo da InternetSetOption negli handle restituiti solo da HttpOpenRequest. Versione: richiede Internet Explorer 8.0 o versione successiva.

WININET_API_FLAG_ASYNC

0x00000001

Forza le operazioni asincrone.

WININET_API_FLAG_SYNC

0x00000004

Forza le operazioni sincrone.

WININET_API_FLAG_USE_CONTEXT

0x00000008

Forza l'API a usare il valore di contesto, anche se è impostato su zero.

Commenti

Requisiti