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.
-
Nota
WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni del server o i servizi, usare i servizi HTTP di Microsoft Windows (WinHTTP).
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |
Intestazione |
|