struttura WINHTTP_AUTOPROXY_OPTIONS (winhttp.h)

  • Articolo

La struttura WINHTTP_AUTOPROXY_OPTIONS viene usata per indicare alla funzione WinHttpGetProxyForURL se specificare l'URL del file PAC (Proxy Auto Configuration) o individuare automaticamente l'URL con le query DHCP o DNS nella rete.

Sintassi

typedef struct _WINHTTP_AUTOPROXY_OPTIONS {
  DWORD   dwFlags;
  DWORD   dwAutoDetectFlags;
  LPCWSTR lpszAutoConfigUrl;
  LPVOID  lpvReserved;
  DWORD   dwReserved;
  BOOL    fAutoLogonIfChallenged;
} WINHTTP_AUTOPROXY_OPTIONS, *PWINHTTP_AUTOPROXY_OPTIONS;

Members

dwFlags

I meccanismi devono essere usati per ottenere il file PAC.

Valore Significato
WINHTTP_AUTOPROXY_ALLOW_AUTOCONFIG
 Abilita il rilevamento del proxy tramite URL autoconfig.
 
Nota Il supporto per questo flag è stato introdotto in Windows 10 versione 1703 (10.0; Build 15063).
 
WINHTTP_AUTOPROXY_ALLOW_CM
 Abilita il rilevamento proxy tramite la gestione connessione.
 
Nota Il supporto per questo flag è stato introdotto in Windows 10 versione 1703 (10.0; Build 15063).
 
WINHTTP_AUTOPROXY_ALLOW_STATIC
 Abilita il rilevamento del proxy tramite la configurazione statica.
 
Nota Il supporto per questo flag è stato introdotto in Windows 10 versione 1703 (10.0; Build 15063).
 
WINHTTP_AUTOPROXY_AUTO_DETECT
 Tentare di individuare automaticamente l'URL del file PAC usando query DHCP e DNS nella rete locale.
WINHTTP_AUTOPROXY_CONFIG_URL
 Scaricare il file PAC dall'URL specificato da lpszAutoConfigUrl nella struttura WINHTTP_AUTOPROXY_OPTIONS .
WINHTTP_AUTOPROXY_HOST_KEEPCASE
 Gestisce il caso dei nomi host passati allo script PAC. Questo è il comportamento predefinito.
WINHTTP_AUTOPROXY_HOST_LOWERCASE
 Converte i nomi host in lettere minuscole prima di passarli allo script PAC.
WINHTTP_AUTOPROXY_NO_CACHE_CLIENT
 Disabilita l'esecuzione di query su un host nella cache proxy dell'esecuzione di script nel processo corrente.
WINHTTP_AUTOPROXY_NO_CACHE_SVC
 Disabilita l'esecuzione di query su un host nella cache proxy dell'esecuzione di script nel servizio autoproxy.
WINHTTP_AUTOPROXY_NO_DIRECTACCESS
 Disabilita l'esecuzione di query sulle impostazioni proxy di Accesso diretto per questa richiesta.
WINHTTP_AUTOPROXY_RUN_INPROCESS
 Esegue il protocollo WPAD (Web Proxy Auto-Discovery) in-process anziché delegare a un servizio WinHTTP AutoProxy out-of-process, se disponibile. Questo flag deve essere combinato con uno degli altri flag.

Questa opzione non ha alcun effetto quando viene passato a WinHttpGetProxyForUrlEx.

Nota Questo flag è deprecato.
 
WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY
 Per impostazione predefinita, WinHTTP è configurato per eseguire il fallback all'individuazione automatica di un proxy in-process. Se questo comportamento di fallback non è auspicabile nel caso in cui un'individuazione out-of-process non riesca, può essere disabilitata usando questo flag.

Questa opzione non ha alcun effetto quando viene passato a WinHttpGetProxyForUrlEx.

Nota Questo flag è disponibile solo in Windows Server 2003.
 
WINHTTP_AUTOPROXY_SORT_RESULTS
Ordina i risultati del proxy in base a un'euristica posizionando prima i proxy più veloci.

dwAutoDetectFlags

Se dwFlags include il flag WINHTTP_AUTOPROXY_AUTO_DETECT, dwAutoDetectFlags specifica quali protocolli devono essere usati per individuare il file PAC. Se vengono specificati entrambi i flag di rilevamento automatico DHCP e DNS, viene usato per primo DHCP; se non viene individuato alcun URL PAC tramite DHCP, viene usato DNS.

Se dwFlags non include il flag WINHTTP_AUTOPROXY_AUTO_DETECT, dwAutoDetectFlags deve essere zero.

Valore Significato
WINHTTP_AUTO_DETECT_TYPE_DHCP
 Usare DHCP per individuare il file di configurazione automatica del proxy.
WINHTTP_AUTO_DETECT_TYPE_DNS_A
 Usare DNS per tentare di individuare il file di configurazione automatica del proxy in un percorso noto nel dominio del computer locale.

lpszAutoConfigUrl

Se dwFlags include il flag WINHTTP_AUTOPROXY_CONFIG_URL, lpszAutoConfigUrl deve puntare a una stringa Unicode con terminazione Null che contiene l'URL del file pac (Proxy Auto Configuration).

Se dwFlags non include il flag WINHTTP_AUTOPROXY_CONFIG_URL, lpszAutoConfigUrl deve essere NULL.

lpvReserved

Riservato per uso futuro; deve essere NULL.

dwReserved

Riservato per utilizzi futuri; deve essere zero.

fAutoLogonIfChallenged

Specifica se le credenziali di dominio del client devono essere inviate automaticamente in risposta a una richiesta di autenticazione NTLM o Negotiate Authentication quando WinHTTP richiede il file PAC.

Se questo flag è TRUE, le credenziali devono essere inviate automaticamente in risposta a una richiesta di autenticazione. Se questo flag è FALSE ed è necessaria l'autenticazione per scaricare il file PAC, la funzione WinHttpGetProxyForUrl ha esito negativo.

Requisiti

Requisito Valore
Client minimo supportato Windows XP, Windows 2000 Professional con SP3 [solo app desktop]
Server minimo supportato Windows Server 2003, Windows 2000 Server con SP3 [solo app desktop]
Intestazione winhttp.h

Vedi anche

Versioni di WinHTTP