Flag di opzione (Wininet.h)

I flag di opzione seguenti vengono usati con le funzioni InternetQueryOption e InternetSetOption . Tutti i flag di opzione validi hanno un valore maggiore o uguale a INTERNET_FIRST_OPTION e minore o uguale a INTERNET_LAST_OPTION.

INTERNET_OPTION_ALTER_IDENTITY

80

Non implementato

INTERNET_OPTION_ASYNC

30

Non implementato.

INTERNET_OPTION_ASYNC_ID

15

Non implementato.

INTERNET_OPTION_ASYNC_PRIORITY

16

Non implementato.

INTERNET_OPTION_BYPASS_EDITED_ENTRY

64

Imposta o recupera il valore booleano che determina se il sistema deve controllare la rete per i contenuti più recenti e sovrascrivere le voci della cache modificate se viene trovata una versione più recente. Se impostato su True, il sistema controlla la rete per il contenuto più recente e sovrascrive la voce della cache modificata con la versione più recente. Il valore predefinito è False, che indica che la voce della cache modificata deve essere usata senza controllare la rete. Viene usato da InternetQueryOption e InternetSetOption. È valido solo in Microsoft Internet Explorer 5 e versioni successive.

INTERNET_OPTION_CACHE_STREAM_HANDLE

27

Non più supportata.

INTERNET_OPTION_CACHE_TIMESTAMPS

69

Recupera una struttura INTERNET_CACHE_TIMESTAMPS che contiene l'ora LastModified e Scade dalla risorsa archiviata nella cache Internet. Questo valore viene usato da InternetQueryOption.

INTERNET_OPTION_CALLBACK

1

Imposta o recupera l'indirizzo della funzione di callback definita per questo handle. Questa opzione può essere usata su tutti gli handle DI HINTERNET . Usato da InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CALLBACK_FILTER

54

Non implementato.

INTERNET_OPTION_CLIENT_CERT_CONTEXT

84

Questo flag non è supportato da InternetQueryOption. Il parametro lpBuffer deve essere un puntatore a una struttura CERT_CONTEXT e non un puntatore a un puntatore a un puntatore CERT_CONTEXT. Se un'applicazione riceve ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED, deve chiamare InternetErrorDlg o usare InternetSetOption per fornire un certificato prima di ripetere la richiesta. CertDuplicateCertificateContext viene quindi chiamato in modo che il contesto del certificato passato possa essere rilasciato in modo indipendente dall'applicazione.

INTERNET_OPTION_CODEPAGE

68

Per impostazione predefinita, la parte host o autorità dell'URL Unicode viene codificata in base alla specifica IDN. Se si imposta questa opzione sulla richiesta o sull'handle di connessione, quando IDN è disabilitato, specifica uno schema di codifica della tabella codici per la parte host dell'URL. Il parametro lpBuffer nella chiamata a InternetSetOption contiene la tabella codici DBCS desiderata. Se non viene specificata alcuna tabella codici in lpBuffer, WinINet usa la tabella codici di sistema predefinita (CP_ACP). Nota: questa opzione viene ignorata se IDN non è disabilitato. Per altre informazioni su come disabilitare IDN, vedere l'opzione INTERNET_OPTION_IDN .

Windows XP con SP2 e Windows Server 2003 con SP1: Questo flag non è supportato.

Versione: Richiede Internet Explorer 7.0.

INTERNET_OPTION_CODEPAGE_PATH

100

Per impostazione predefinita, la parte del percorso dell'URL è codificata UTF8. L'API WinINet esegue la codifica carattere di escape (%) nei caratteri a bit elevato. L'impostazione di questa opzione nella richiesta o nell'handle di connessione disabilita la codifica UTF8 e imposta una tabella codici specifica. Il parametro lpBuffer nella chiamata a InternetSetOption contiene la pagina di codice DBCS desiderata per il percorso. Se non viene specificata alcuna tabella codici in lpBuffer, WinINet usa la CP_UTF8 predefinita.

Windows XP con SP2 e Windows Server 2003 con SP1: Questo flag non è supportato.

Versione: Richiede Internet Explorer 7.0.

INTERNET_OPTION_CODEPAGE_EXTRA

101

Per impostazione predefinita, la parte del percorso dell'URL è la tabella codici di sistema predefinita (CP_ACP). Le conversioni del carattere di escape (%) non vengono eseguite nella parte aggiuntiva. L'impostazione di questa opzione nella richiesta o nell'handle di connessione disabilita la codifica CP_ACP. Il parametro lpBuffer nella chiamata a InternetSetOption contiene la pagina di codice DBCS desiderata per la parte aggiuntiva dell'URL. Se non viene specificata alcuna tabella codici in lpBuffer, WinINet usa la tabella codici di sistema predefinita (CP_ACP).

Windows XP con SP2 e Windows Server 2003 con SP1: Questo flag non è supportato.

Versione: Richiede Internet Explorer 7.0.

INTERNET_OPTION_COMPRESSED_CONTENT_LENGTH

147

Per una richiesta in cui WinInet decompresse il server fornito Content-Encoding, recupera la lunghezza del contenuto segnalata dal server del corpo della risposta come ULONGLONG. Supportato in Windows 10 versione 1507 e versioni successive.

INTERNET_OPTION_CONNECT_BACKOFF

4

Non implementato.

INTERNET_OPTION_CONNECT_RETRIES

3

Imposta o recupera un valore intero lungo senza segno che contiene il numero di volte in cui WinINet tenta di risolvere e connettersi a un host. Tenta solo una volta per ogni indirizzo IP. Ad esempio, se si tenta di connettersi a un host multihome con dieci indirizzi IP e INTERNET_OPTION_CONNECT_RETRIES è impostato su sette, WinINet tenta solo di risolvere e connettersi ai primi sette indirizzi IP. Al contrario, dato lo stesso set di dieci indirizzi IP, se INTERNET_OPTION_CONNECT_RETRIES è impostato su 20, WinINet tenta ogni sola volta. Se un host ha un solo indirizzo IP e il primo tentativo di connessione ha esito negativo, non sono presenti altri tentativi. Se un tentativo di connessione non riesce ancora dopo il numero specificato di tentativi, la richiesta viene annullata. Il valore predefinito per INTERNET_OPTION_CONNECT_RETRIES è di cinque tentativi. Questa opzione può essere usata in qualsiasi handle HINTERNET , incluso un handle NULL . Viene usato da InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CONNECT_TIME

55

Non implementato.

INTERNET_OPTION_CONNECT_TIMEOUT

2

Imposta o recupera un valore intero lungo senza segno che contiene il valore di timeout, in millisecondi, da usare per le richieste di connessione Internet. L'impostazione di questa opzione su infinito (0xFFFFFFFF) disabilita questo timer.

Se una richiesta di connessione richiede più tempo di questo valore di timeout, la richiesta viene annullata. Quando si tenta di connettersi a più indirizzi IP per un singolo host (un host multihome), il limite di timeout è cumulativo per tutti gli indirizzi IP. Questa opzione può essere usata in qualsiasi handle HINTERNET , incluso un handle NULL . Viene usato da InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CONNECTED_STATE

50

Imposta o recupera un valore intero lungo senza segno che contiene lo stato connesso. Viene usato da InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CONTEXT_VALUE

45

Imposta o recupera un DWORD_PTR contenente l'indirizzo del valore di contesto associato a questo handle HINTERNET . Questa opzione può essere usata in qualsiasi handle HINTERNET . Viene usato da InternetQueryOption e InternetSetOption. In precedenza, questo imposta il valore di contesto sull'indirizzo archiviato nel puntatore lpBuffer . Questa operazione è stata corretta in modo che il valore archiviato nel buffer venga usato e che il flag di INTERNET_OPTION_CONTEXT_VALUE venga assegnato un nuovo valore. Il valore precedente, 10, è stato mantenuto in modo che le applicazioni scritte per il comportamento precedente siano ancora supportate.

INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT

6

Identico a INTERNET_OPTION_RECEIVE_TIMEOUT. Viene usato da InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CONTROL_SEND_TIMEOUT

5

Identico a INTERNET_OPTION_SEND_TIMEOUT. Viene usato da InternetQueryOption e InternetSetOption.

INTERNET_OPTION_DATA_RECEIVE_TIMEOUT

8

Imposta o recupera un valore intero lungo senza segno che contiene il valore di timeout, in millisecondi, per ricevere una risposta a una richiesta per il canale dati di una transazione FTP. Se la risposta richiede più tempo di questo valore di timeout, la richiesta viene annullata. Questa opzione può essere usata in qualsiasi handle HINTERNET , incluso un handle NULL . Viene usato da InternetQueryOption e InternetSetOption.

Questo flag non ha alcun impatto sulla funzionalità HTTP.

INTERNET_OPTION_DATA_SEND_TIMEOUT

7

Imposta o recupera un valore intero lungo senza segno, in millisecondi, che contiene il valore di timeout per inviare una richiesta per il canale dati di una transazione FTP. Se l'invio richiede più tempo di questo valore di timeout, l'invio viene annullato. Questa opzione può essere usata in qualsiasi handle HINTERNET , incluso un handle NULL . Viene usato da InternetQueryOption e InternetSetOption.

Questo flag non ha alcun impatto sulla funzionalità HTTP.

INTERNET_OPTION_DATAFILE_NAME

33

Recupera un valore stringa contenente il nome del file che esegue il backup di un'entità scaricata. Questo flag è valido dopo il completamento di InternetOpenUrl, FtpOpenFile, GopherOpenFile o HttpOpenRequest . Questa opzione può essere eseguita solo da InternetQueryOption.

INTERNET_OPTION_DATAFILE_EXT

96

Imposta un valore stringa contenente l'estensione del file che esegue il backup di un'entità scaricata. Questo flag deve essere impostato prima di chiamare InternetOpenUrl, FtpOpenFile, GopherOpenFile o HttpOpenRequest. Questa opzione può essere impostata solo da InternetSetOption.

INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO

67

Recupera una struttura INTERNET_DIAGNOSTIC_SOCKET_INFO che contiene dati relativi a una richiesta HTTP specificata. Questo flag viene usato da InternetQueryOption.

Windows 7: Questa opzione non è più supportata.

INTERNET_OPTION_DIGEST_AUTH_UNLOAD

76

Fa sì che il sistema disconnettersi dal pacchetto SSPI di autenticazione digest, rimuovendo tutte le credenziali create per il processo. Per questa opzione non è necessario alcun buffer. Viene usato da InternetSetOption.

INTERNET_OPTION_DISABLE_AUTODIAL

70

Non implementato.

INTERNET_OPTION_DISCONNECTED_TIMEOUT

49

Non implementato.

INTERNET_OPTION_ENABLE_HTTP_PROTOCOL

148

Imposta una maschera di bit DWORD di versioni HTTP accettabili. Può essere impostato su qualsiasi tipo di handle. I valori possibili sono:

• HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Supportato in Windows 10 versione 1507 e versioni successive.

Le versioni legacy di HTTP (1.1 e precedenti) non possono essere disabilitate usando questa opzione. Il valore predefinito è 0x0. Supportato in Windows 10 versione 1507 e versioni successive.

INTERNET_OPTION_ENABLE_REDIRECT_CACHE_READ

122

In un handle di richiesta imposta un controllo booleano che indica se i reindirizzamenti verranno restituiti dalla cache WinInet per una determinata richiesta. Il valore predefinito è FALSE. Supportato in Windows 8 e versioni successive.

INTERNET_OPTION_ENCODE_EXTRA

155

Ottiene/imposta un valore BOOL che indica se i caratteri non ASCII nella stringa di query devono essere codificati in percentuale. Il valore predefinito è FALSE. Supportato in Windows 8.1 e versioni successive.

INTERNET_OPTION_END_BROWSER_SESSION

42

Scarica le voci non usate dalla cache delle password nel disco rigido. Reimposta anche il tempo di cache usato quando la modalità di sincronizzazione è una sola volta per sessione. Per questa opzione non è necessario alcun buffer. Questa operazione viene usata da InternetSetOption.

INTERNET_OPTION_ERROR_MASK

62

Imposta un valore intero lungo senza segno che contiene le maschere di errore che possono essere gestite dall'applicazione client. Questa può essere una combinazione dei valori seguenti:

INTERNET_ERROR_MASK_COMBINED_SEC_CERT

0x2

Indica che tutti gli errori del certificato devono essere segnalati usando lo stesso errore restituito, ovvero ERROR_INTERNET_SEC_CERT_ERRORS. Se questo flag è impostato, chiamare InternetErrorDlg quando riceve l'errore di ERROR_INTERNET_SEC_CERT_ERRORS , in modo che l'utente possa rispondere a un dialogo familiare che descrive il problema.

Attenzione

Non è possibile informare l'utente di questo errore espone l'utente a potenziali attacchi di spoofing.

INTERNET_ERROR_MASK_INSERT_CDROM

0x1

Indica che l'applicazione client può gestire il codice di errore ERROR_INTERNET_INSERT_CDROM .

INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY

0x8

Indica che l'applicazione client può gestire il codice di errore ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY .

INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG

0x4

Non implementato.

INTERNET_OPTION_ENTERPRISE_CONTEXT

159

Imposta un PWSTR contenente l'ID Enterprise (vedere https://msdn.microsoft.com/library/windows/desktop/mt759320(v=vs.85).aspx) che si applica alla richiesta. Supportato in Windows 10 versione 1507 e versioni successive.

INTERNET_OPTION_EXTENDED_ERROR

24

Recupera un valore intero lungo senza segno che contiene un codice di errore Winsock mappato ai messaggi di errore di ERROR_INTERNET_ restituiti nel contesto del thread. Questa opzione viene usata in un handle NULL HINTERNET da InternetQueryOption.

INTERNET_OPTION_FROM_CACHE_TIMEOUT

63

Imposta o recupera un valore intero lungo senza segno a1n che contiene la quantità di tempo in cui il sistema deve attendere una risposta a una richiesta di rete prima di controllare la cache per una copia della risorsa. Se una richiesta di rete richiede più tempo rispetto al tempo specificato e la risorsa richiesta è disponibile nella cache, la risorsa viene recuperata dalla cache. Viene usato da InternetQueryOption e InternetSetOption.

INTERNET_OPTION_HANDLE_TYPE

9

Recupera un valore intero lungo senza segno che contiene il tipo di handle KPINET passati. Questa operazione viene usata da InternetQueryOption su qualsiasi handle HINTERNET . I valori restituiti possibili includono quanto segue.

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

Ottiene/imposta un valore BOOL che indica se WinInet deve seguire le direttive HTTP Strict Transport Security (HSTS) dai server. Se abilitata, https:// richieste schemate ai domini con criteri HSTS memorizzati nella cache da WinInet verranno reindirizzati agli URL corrispondenti https://. Il valore predefinito è FALSE. Supportato in Windows 8.1 e versioni successive.

INTERNET_OPTION_HTTP_DECODING

65

Consente a WinINet di eseguire la decodifica per gli schemi di codifica gzip e deflate. Per altre informazioni, vedere Codifica contenuto.

INTERNET_OPTION_HTTP_PROTOCOL_USED

149

Ottiene una DWORD che indica quale versione HTTP avanzata è stata usata in una determinata richiesta. I valori possibili sono:

• HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Supportato in Windows 10 versione 1507 e versioni successive.

0x0 indica HTTP/1.1 o versioni precedenti; vedere INTERNET_OPTION_HTTP_VERSION se è necessaria maggiore precisione su quale versione legacy è stata usata. Supportato in Windows 10 versione 1507 e versioni successive.

INTERNET_OPTION_HTTP_VERSION

59

Imposta o recupera una struttura HTTP_VERSION_INFO contenente la versione HTTP supportata. Questa operazione deve essere usata in un handle NULL . Viene usato da InternetQueryOption e InternetSetOption.

In Windows 7, Windows Server 2008 R2 e versioni successive, il valore del membro dwMinorVersion nella struttura HTTP_VERSION_INFO viene sottoposto a override dalle impostazioni di Internet Explorer. EnableHttp1_1 è un valore del Registro di sistema in HKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE controllato da Opzioni Internet impostate in Internet Explorer per il sistema. Il valore EnableHttp1_1 è predefinito su 1. La struttura HTTP_VERSION_INFO viene ignorata per qualsiasi versione HTTP minore di 1.1 se EnableHttp1_1 è impostata su 1.

INTERNET_OPTION_IDENTITY

78

Non implementato.

INTERNET_OPTION_IDLE_STATE

51

Non implementato.

INTERNET_OPTION_IDN

102

Per impostazione predefinita, la parte host o autorità dell'URL viene codificata in base alla specifica IDN per le connessioni dirette e proxy. Questa opzione può essere usata nella richiesta o nell'handle di connessione per abilitare o disabilitare IDN. Quando L'IDN è disabilitato, WinINet usa la tabella codici di sistema per codificare la parte host o dell'autorità dell'URL. Per disabilitare la conversione dell'host IDN, impostare il parametro lpBuffer nella chiamata a InternetSetOption su zero. Per abilitare la conversione IDN solo nella connessione diretta, specificare INTERNET_FLAG_IDN_DIRECT nel parametro lpBuffer nella chiamata a InternetSetOption. Per abilitare la conversione IDN solo nella connessione proxy, specificare INTERNET_FLAG_IDN_PROXY nel parametro lpBuffer nella chiamata a InternetSetOption.

Windows XP con SP2 e Windows Server 2003 con SP1: Questo flag non è supportato.

Versione: Richiede Internet Explorer 7.0.

INTERNET_OPTION_IGNORE_OFFLINE

77

Imposta o recupera se il flag offline globale deve essere ignorato per l'handle di richiesta specificato. Per questa opzione non è necessario alcun buffer. Viene usato da InternetQueryOption e InternetSetOption con un handle di richiesta. Questa opzione è valida solo in Internet Explorer 5 e versioni successive.

INTERNET_OPTION_KEEP_CONNECTION

22

Non implementato.

INTERNET_OPTION_LISTEN_TIMEOUT

11

Non implementato.

INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER

74

Imposta o recupera un valore intero long senza segno che contiene il numero massimo di connessioni consentite per server HTTP/1.0. Viene usato da InternetQueryOption e InternetSetOption. Questa opzione è valida solo in Internet Explorer 5 e versioni successive.

INTERNET_OPTION_MAX_CONNS_PER_PROXY

103

Imposta o recupera un valore intero long senza segno che contiene il numero massimo di connessioni consentite per ogni proxy CERN. Quando questa opzione viene impostata o recuperata, il parametro hInternet deve essere impostato su un valore handle Null . Un valore handle Null indica che l'opzione deve essere impostata o eseguita una query per il processo corrente. Quando si chiama InternetSetOption con questa opzione, tutti gli oggetti proxy esistenti riceveranno il nuovo valore. Questo valore è limitato a un intervallo compreso tra 2 e 128 inclusi.

Versione: Richiede Internet Explorer 8.0.

INTERNET_OPTION_MAX_CONNS_PER_SERVER

73

Imposta o recupera un valore intero long senza segno che contiene il numero massimo di connessioni consentite per server. Viene usato da InternetQueryOption e InternetSetOption. Questa opzione è valida solo in Internet Explorer 5 e versioni successive.

INTERNET_OPTION_OFFLINE_MODE

26

Non implementato.

INTERNET_OPTION_OFFLINE_SEMANTICS

52

Non implementato.

INTERNET_OPTION_OPT_IN_WEAK_SIGNATURE

176

Acconsentire esplicitamente a firme deboli (ad esempio SHA-1) da considerare non sicure. In questo modo WinInet chiamerà CertGetCertificateChain usando il parametro CERT_CHAIN_OPT_IN_WEAK_SIGNATURE .

INTERNET_OPTION_PARENT_HANDLE

21

Recupera l'handle padre in questo handle. Questa opzione può essere utilizzata in qualsiasi handle DELLA RETE GESTITA da InternetQueryOption.

INTERNET_OPTION_PASSWORD

29

Imposta o recupera un valore stringa contenente la password associata a un handle restituito da InternetConnect. Viene usato da InternetQueryOption e InternetSetOption.

INTERNET_OPTION_PER_CONNECTION_OPTION

75

Imposta o recupera una struttura INTERNET_PER_CONN_OPTION_LIST che specifica un elenco di opzioni per una determinata connessione. Viene usato da InternetQueryOption e InternetSetOption. Questa opzione è valida solo in Internet Explorer 5 e versioni successive.

Nota

INTERNET_OPTION_PER_CONNECTION_OPTION fa sì che le impostazioni vengano modificate a livello di sistema quando viene usato un handle NULL nella chiamata a InternetSetOption. Per aggiornare le impostazioni proxy globali, è necessario chiamare InternetSetOption con il flag di opzione INTERNET_OPTION_REFRESH .

Nota

Per modificare le informazioni proxy per l'intero processo senza influire sulle impostazioni globali in Internet Explorer 5 e versioni successive, usare questa opzione nell'handle restituito da InternetOpen. Nell'esempio di codice seguente viene modificato il proxy per l'intero processo, anche se l'handle DELLA RETE È chiuso e non viene usato da alcuna richiesta.

INTERNET_OPTION_POLICY

48

Non implementato.

INTERNET_OPTION_PROXY

38

Imposta o recupera una struttura INTERNET_PROXY_INFO che contiene i dati proxy per un handle InternetOpen esistente quando l'handle DELLA RETE NON È NULL. Se l'handle DELL'interfaccia DI RETE ÈNULL, la funzione imposta o esegue una query sui dati del proxy globale. Questa opzione può essere usata nell'handle restituito da InternetOpen. Viene usato da InternetQueryOption e InternetSetOption.

Nota

È consigliabile usare INTERNET_OPTION_PER_CONNECTION_OPTION anziché INTERNET_OPTION_PROXY.

INTERNET_OPTION_PROXY_PASSWORD

44

Imposta o recupera un valore stringa contenente la password utilizzata per accedere al proxy. Viene usato da InternetQueryOption e InternetSetOption. Questa opzione può essere impostata sull'handle restituito da InternetConnect o HttpOpenRequest.

INTERNET_OPTION_PROXY_SETTINGS_CHANGED

95

Avvisa l'istanza di WinInet corrente che le impostazioni proxy sono state modificate e che devono essere aggiornate con le nuove impostazioni. Per avvisare tutte le istanze WinInet disponibili, impostare il parametro Buffer di InternetSetOption su NULL e BufferLength su 0 quando si passa questa opzione. Questa opzione può essere impostata sull'handle restituito da InternetConnect o HttpOpenRequest.

INTERNET_OPTION_PROXY_USERNAME

43

Imposta o recupera un valore stringa contenente il nome utente utilizzato per accedere al proxy. Viene usato da InternetQueryOption e InternetSetOption. Questa opzione può essere impostata sull'handle restituito da InternetConnect o HttpOpenRequest.

INTERNET_OPTION_READ_BUFFER_SIZE

12

Imposta o recupera un valore intero long senza segno che contiene le dimensioni del buffer di lettura. Questa opzione può essere usata negli handle DELLANET RESTITUITi da FtpOpenFile, FtpFindFirstFile e InternetConnect (solo sessione FTP). Questa opzione viene utilizzata da InternetQueryOption e InternetSetOption.

INTERNET_OPTION_RECEIVE_THROUGHPUT

57

Non implementato.

INTERNET_OPTION_RECEIVE_TIMEOUT

6

Imposta o recupera un valore intero long senza segno che contiene il valore di timeout, espresso in millisecondi, per ricevere una risposta a una richiesta. Se la risposta richiede più tempo di questo valore di timeout, la richiesta viene annullata. Questa opzione può essere usata in qualsiasi handle DI RETE, incluso un handle NULL . Viene usato da InternetQueryOption e InternetSetOption.

Questa opzione non è progettata per rappresentare un timeout immediato con granularità fine. È possibile prevedere che il timeout si verifichi fino a sei secondi dopo il valore di timeout impostato.

Se usato in riferimento a una transazione FTP, questa opzione fa riferimento al canale di controllo.

INTERNET_OPTION_REFRESH

37

Fa sì che i dati proxy vengano rilette dal Registro di sistema per un handle. Non è necessario alcun buffer. Questa opzione può essere utilizzata nell'handle DELL'interfaccia DI RETE RESTITUITA da InternetOpen. Viene utilizzato da InternetSetOption.

INTERNET_OPTION_REMOVE_IDENTITY

79

Non implementato.

INTERNET_OPTION_REQUEST_FLAGS

23

Recupera un valore intero lungo senza segno che contiene i flag di stato speciali che indicano lo stato del download in corso. Viene usato da InternetQueryOption. L'opzione INTERNET_OPTION_REQUEST_FLAGS può essere uno dei valori seguenti:

INTERNET_REQFLAG_ASYNC

0x00000002

Non implementato.

INTERNET_REQFLAG_CACHE_WRITE_DISABLED

0x00000040

La richiesta Internet non può essere memorizzata nella cache ,ad esempio una richiesta HTTPS.

INTERNET_REQFLAG_FROM_CACHE

0x00000001

La risposta proviene dalla cache.

INTERNET_REQFLAG_NET_TIMEOUT

0x00000080

Timeout della richiesta Internet.

INTERNET_REQFLAG_NO_HEADERS

0x00000008

La risposta originale non contiene intestazioni.

INTERNET_REQFLAG_PASSIVE

0x00000010

Non implementato.

INTERNET_REQFLAG_VIA_PROXY

0x00000004

La richiesta è stata effettuata tramite un proxy.

INTERNET_OPTION_REQUEST_PRIORITY

58

Imposta o recupera un valore intero long senza segno che contiene la priorità delle richieste che competono per una connessione in un handle HTTP. Viene usato da InternetQueryOption e InternetSetOption.

INTERNET_OPTION_RESET_URLCACHE_SESSION

60

Avvia una nuova sessione della cache per il processo. Non è necessario alcun buffer. Viene utilizzato da InternetSetOption. Questa opzione è riservata solo per uso interno.

INTERNET_OPTION_SECONDARY_CACHE_KEY

53

Imposta o recupera un valore stringa che contiene la chiave della cache secondaria. Viene usato da InternetQueryOption e InternetSetOption. Questa opzione è riservata solo per uso interno.

INTERNET_OPTION_SECURITY_CERTIFICATE

35

Recupera il certificato per un server SSL/PCT (Secure Sockets Layer/Private Communications Technology) in una stringa formattata. Viene usato da InternetQueryOption.

INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT

32

Recupera il certificato per un server SSL/PCT nella struttura INTERNET_CERTIFICATE_INFO. Viene usato da InternetQueryOption.

INTERNET_OPTION_SECURITY_FLAGS

31

Recupera un valore long integer senza segno che contiene i flag di sicurezza per un handle. Questa opzione viene usata da InternetQueryOption. Può essere una combinazione dei valori seguenti.

SECURITY_FLAG_128BIT

0x20000000

Identico al valore preferito SECURITY_FLAG_STRENGTH_STRONG. Viene restituito solo in una chiamata a InternetQueryOption.

SECURITY_FLAG_40BIT

0x10000000

Identico al valore preferito SECURITY_FLAG_STRENGTH_WEAK. Viene restituito solo in una chiamata a InternetQueryOption.

SECURITY_FLAG_56BIT

0x40000000

Identico al valore preferito SECURITY_FLAG_STRENGTH_MEDIUM. Viene restituito solo in una chiamata a InternetQueryOption.

SECURITY_FLAG_FORTEZZA

0x08000000

Indica che Fortezza è stato usato per fornire segreto, autenticazione e/o integrità per la connessione specificata.

SECURITY_FLAG_IETFSSL4

0x00000020

Non implementato.

SECURITY_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

Ignora il messaggio di errore ERROR_INTERNET_SEC_CERT_CN_INVALID .

SECURITY_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

Ignora il messaggio di errore ERROR_INTERNET_SEC_CERT_DATE_INVALID .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

Ignora il messaggio di errore ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

Ignora il messaggio di errore ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR .

SECURITY_FLAG_IGNORE_REVOCATION

0x00000080

Ignora i problemi di revoca dei certificati.

SECURITY_FLAG_IGNORE_UNKNOWN_CA

0x00000100

Ignora i problemi sconosciuti dell'autorità di certificazione.

SECURITY_FLAG_IGNORE_WEAK_SIGNATURE

0x00010000

Ignora i problemi di firma dei certificati deboli.

SECURITY_FLAG_IGNORE_WRONG_USAGE

0x00000200

Ignora i problemi di utilizzo non corretti.

SECURITY_FLAG_NORMALBITNESS

0x10000000

Identico al valore SECURITY_FLAG_STRENGTH_WEAK. Viene restituito solo in una chiamata a InternetQueryOption.

SECURITY_FLAG_PCT

0x00000008

Non implementato.

SECURITY_FLAG_PCT4

0x00000010

Non implementato.

SECURITY_FLAG_SECURE

0x00000001

Usa trasferimenti sicuri. Viene restituito solo in una chiamata a InternetQueryOption.

SECURITY_FLAG_SSL

0x00000002

Non implementato.

SECURITY_FLAG_SSL3

0x00000004

Non implementato.

SECURITY_FLAG_STRENGTH_MEDIUM

0x40000000

Usa la crittografia media (a 56 bit). Viene restituito solo in una chiamata a InternetQueryOption.

SECURITY_FLAG_STRENGTH_STRONG

0x20000000

Usa la crittografia avanzata (a 128 bit). Viene restituito solo in una chiamata a InternetQueryOption.

SECURITY_FLAG_STRENGTH_WEAK

0x10000000

Usa la crittografia debole (a 40 bit). Viene restituito solo in una chiamata a InternetQueryOption.

SECURITY_FLAG_UNKNOWNBIT

0x80000000

Le dimensioni di bit usate nella crittografia sono sconosciute. Viene restituito solo in una chiamata a InternetQueryOption.

Tenere presente che i dati recuperati in questo modo si riferiscono a una transazione che si è verificata, il cui livello di sicurezza non può più essere modificato.

INTERNET_OPTION_SECURITY_KEY_BITNESS

36

Recupera un valore intero lungo senza segno che contiene le dimensioni del bit della chiave di crittografia. Maggiore è il numero, maggiore è la forza di crittografia usata. Questa operazione viene usata da InternetQueryOption. Tenere presente che i dati recuperati in questo modo si riferiscono a una transazione già verificata, il cui livello di sicurezza non può più essere modificato.

INTERNET_OPTION_SEND_THROUGHPUT

56

Non implementato.

INTERNET_OPTION_SEND_TIMEOUT

5

Imposta o recupera un valore intero lungo senza segno, in millisecondi, che contiene il valore di timeout per inviare una richiesta. Se l'invio richiede più tempo di questo valore di timeout, l'invio viene annullato. Questa opzione può essere usata in qualsiasi handle HINTERNET , incluso un handle NULL . Viene usato da InternetQueryOption e InternetSetOption.

Se usato in riferimento a una transazione FTP, questa opzione fa riferimento al canale di controllo.

INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT

105

Recupera il contesto della catena di certificati del server come PCCERT_CHAIN_CONTEXT duplicato. È possibile passare questo contesto duplicato a qualsiasi funzione API Crypto che accetta un PCCERT_CHAIN_CONTEXT. È necessario chiamare CertFreeCertificateChain nel PCCERT_CHAIN_CONTEXT restituito al termine del contesto della catena di certificati.

Versione: Richiede Internet Explorer 8.0.

INTERNET_OPTION_SETTINGS_CHANGED

39

Notifica al sistema che le impostazioni del Registro di sistema sono state modificate in modo da verificare le impostazioni nella chiamata successiva a InternetConnect. Questa operazione viene usata da InternetSetOption.

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 differisce dal flag request INTERNET_FLAG_NO_AUTH, che impedisce l'autenticazione a server proxy e server di origine.

L'impostazione di questa modalità elimina l'uso di qualsiasi materiale delle credenziali (precedentemente fornito 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 per le 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 di INTERNET_FLAG_NO_COOKIES .

Questa opzione può essere impostata solo sugli oggetti richiesta prima dell'invio. Tenta di impostare questa opzione dopo l'invio della richiesta restituirà ERROR_INTERNET_INCORRECT_HANDLE_STATE.

Per questa opzione non è necessario alcun buffer. Questa operazione viene usata da InternetSetOption negli handle restituiti solo da HttpOpenRequest .

Versione: Richiede Internet Explorer 8.0 o versione successiva.

INTERNET_OPTION_SUPPRESS_BEHAVIOR

81

Opzione di utilizzo generico usata per eliminare i comportamenti a livello di processo. Il parametro lpBuffer della funzione deve essere un puntatore a un DWORD contenente il comportamento specifico da eliminare. Questa opzione non può essere eseguita una query con InternetQueryOption. I valori consentiti sono:

INTERNET_SUPPRESS_RESET_ALL

0

Disabilita tutte le eliminazioni, riattivando il comportamento predefinito e configurato. Questa opzione è l'equivalente dell'impostazione INTERNET_SUPPRESS_COOKIE_POLICY_RESET e INTERNET_SUPPRESS_COOKIE_PERSIST_RESET singolarmente .

Versione: Richiede Internet Explorer 6.0 o versione successiva.

INTERNET_SUPPRESS_COOKIE_POLICY

1

Ignora i criteri dei cookie configurati e consente di impostare i cookie.

Versione: Richiede Internet Explorer 6.0 o versione successiva.

INTERNET_SUPPRESS_COOKIE_POLICY_RESET

2

Disabilita l'eliminazione INTERNET_SUPPRESS_COOKIE_POLICY , consentendo la valutazione dei cookie in base ai criteri di cookie configurati.

Versione: Richiede Internet Explorer 6.0 o versione successiva.

INTERNET_SUPPRESS_COOKIE_PERSIST

3

Elimina la persistenza dei cookie, anche se il server li ha specificati come persistenti.

Versione: Richiede Internet Explorer 8.0 o versione successiva.

INTERNET_SUPPRESS_COOKIE_PERSIST_RESET

4

Disabilita l'eliminazione INTERNET_SUPPRESS_COOKIE_PERSIST , riattivando la persistenza dei cookie. Tutti i cookie eliminati in precedenza non diventeranno persistenti.

Versione: Richiede Internet Explorer 8.0 o versione successiva.

INTERNET_OPTION_URL

34

Recupera un valore stringa contenente l'URL completo di una risorsa scaricata. Se l'URL originale contiene dati aggiuntivi, ad esempio stringhe di ricerca o ancoraggi o se la chiamata è stata reindirizzata, l'URL restituito è diverso dall'originale. Questa opzione è valida negli handle DI HINTERNET restituiti da InternetOpenUrl, FtpOpenFile, GopherOpenFile o HttpOpenRequest. Viene usato da InternetQueryOption.

INTERNET_OPTION_USER_AGENT

41

Imposta o recupera la stringa dell'agente utente sugli handle forniti da InternetOpen e usati nelle funzioni HttpSendRequest successive, purché non venga sottoposto a override da un'intestazione aggiunta da HttpAddRequestHeaders o HttpSendRequest. Viene usato da InternetQueryOption e InternetSetOption.

INTERNET_OPTION_USERNAME

28

Imposta o recupera una stringa contenente il nome utente associato a un handle restituito da InternetConnect. Viene usato da InternetQueryOption e InternetSetOption.

INTERNET_OPTION_VERSION

40

Recupera una struttura INTERNET_VERSION_INFO contenente il numero di versione di Wininet.dll. Questa opzione può essere usata in un handle NULLHINTERNET da InternetQueryOption.

INTERNET_OPTION_WRITE_BUFFER_SIZE

13

Imposta o recupera un valore intero lungo senza segno che contiene le dimensioni, in byte, del buffer di scrittura. Questa opzione può essere usata negli handle DI HINTERNET restituiti da FtpOpenFile e InternetConnect (solo sessione FTP). Viene usato da InternetQueryOption e InternetSetOption.

Commenti

Nota

WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni o i servizi server usano Microsoft Windows HTTP Services (WinHTTP).

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Wininet.h; Winineti.h