struttura INTERNET_PER_CONN_OPTIONA (wininet.h)

Contiene il valore di un'opzione.

Sintassi

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPSTR    pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONA, *LPINTERNET_PER_CONN_OPTIONA;

Membri

dwOption

Opzione su cui eseguire query o impostare. Questo membro può essere uno dei valori seguenti.

Valore	Significato
INTERNET_PER_CONN_AUTOCONFIG_URL	Imposta o recupera una stringa contenente l'URL dello script di configurazione automatica.
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS	Imposta o recupera le impostazioni di individuazione automatica. Il membro Value conterrà uno o più dei valori seguenti: AUTO_PROXY_FLAG_ALWAYS_DETECT Rilevare sempre automaticamente le impostazioni. AUTO_PROXY_FLAG_CACHE_INIT_RUN Indica che i risultati memorizzati nella cache dello script di configurazione del proxy automatico devono essere usati, invece di eseguire effettivamente lo script, a meno che il file memorizzato nella cache non sia scaduto. AUTO_PROXY_FLAG_DETECTION_RUN Il rilevamento automatico è stato eseguito almeno una volta in questa connessione. AUTO_PROXY_FLAG_DETECTION_SUSPECT Attualmente non supportato. AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT Non consentire la memorizzazione nella cache del risultato dello script di configurazione proxy automatico. AUTO_PROXY_FLAG_MIGRATED L'impostazione è stata eseguita la migrazione da un'installazione di Microsoft Internet Explorer 4.0 e il rilevamento automatico deve essere eseguito una sola volta. AUTO_PROXY_FLAG_USER_SET L'utente ha impostato in modo esplicito il rilevamento automatico.
INTERNET_PER_CONN_FLAGS	Imposta o recupera il tipo di connessione. Il membro Value conterrà uno o più dei valori seguenti: PROXY_TYPE_DIRECT La connessione non usa un server proxy. PROXY_TYPE_PROXY La connessione usa un server proxy impostato in modo esplicito. PROXY_TYPE_AUTO_PROXY_URL La connessione scarica ed elabora uno script di configurazione automatica in un URL specificato. PROXY_TYPE_AUTO_DETECT La connessione rileva automaticamente le impostazioni.
INTERNET_PER_CONN_PROXY_BYPASS	Imposta o recupera una stringa contenente gli URL che non usano il server proxy.
INTERNET_PER_CONN_PROXY_SERVER	Imposta o recupera una stringa contenente i server proxy.
INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL	URL autoconfig concatenato. Usato quando l'URL di autoconfig primario punta a un file INS che imposta un secondo URL di autoconfig per le informazioni sul proxy.
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS	di minuti fino all'aggiornamento automatico dell'URL di autoconfig tramite individuazione automatica.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME	Opzione di sola lettura. Restituisce l'ora in cui è stato trovato l'ultimo URL di autoconfig valido noto usando l'individuazione automatica.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL	Opzione di sola lettura. Restituisce l'ultimo URL valido noto trovato usando l'individuazione automatica.

 

Windows 7 e versioni successive:

I client che supportano Internet Explorer 8 devono eseguire query sul tipo di connessione usando INTERNET_PER_CONN_FLAGS_UI. Se la query ha esito negativo, il sistema esegue una versione precedente di Internet Explorer e il client deve eseguire di nuovo una query con INTERNET_PER_CONN_FLAGS.

Ripristinare il tipo di connessione usando INTERNET_PER_CONN_FLAGS indipendentemente dalla versione di Internet Explorer.

Valore

Significato

INTERNET_PER_CONN_FLAGS_UI

Imposta o recupera il tipo di connessione. Il membro Value conterrà uno o più dei valori seguenti: PROXY_TYPE_DIRECT La connessione non usa un server proxy. PROXY_TYPE_PROXY La connessione usa un server proxy impostato in modo esplicito. PROXY_TYPE_AUTO_PROXY_URL La connessione scarica ed elabora uno script di configurazione automatica in un URL specificato. PROXY_TYPE_AUTO_DETECT La connessione rileva automaticamente le impostazioni.

Value

Unione contenente il valore per l'opzione. Può essere uno dei tipi seguenti a seconda del valore di dwOption:

dwValue

Valore intero lungo senza segno.

pszValue

Puntatore a un valore stringa.

ftValue

Struttura FILETIME.

Value.dwValue

Value.pszValue

Value.ftValue

Osservazioni

In Internet Explorer 5, solo le versioni ANSI di InternetQueryOption e InternetSetOption funzioneranno con la struttura INTERNET_PER_CONN_OPTION. Le versioni Unicode supporteranno la struttura INTERNET_PER_CONN_OPTION nelle versioni successive di Internet Explorer.

Per le query che restituiscono stringhe, InternetQueryOption alloca la memoria per il pszValue membro della struttura. L'applicazione chiamante deve liberare questa memoria usando la funzione GlobalFree al termine dell'utilizzo della stringa.

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 Servizi HTTP Di Microsoft Windows (WinHTTP).

 

Nota

L'intestazione wininet.h definisce INTERNET_PER_CONN_OPTION come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	wininet.h

Vedere anche

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption

InternetSetOption