WINHTTP_AUTOPROXY_OPTIONS-Struktur (winhttp.h)

  • Artikel

Die WINHTTP_AUTOPROXY_OPTIONS-Struktur wird verwendet, um der WinHttpGetProxyForURL-Funktion anzugeben, ob die URL der Pac-Datei (Proxy Auto-Configuration) angegeben oder die URL automatisch mit DHCP- oder DNS-Abfragen an das Netzwerk gefunden werden soll.

Syntax

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

Member

dwFlags

Zum Abrufen der PAC-Datei sollten Mechanismen verwendet werden.

Wert Bedeutung
WINHTTP_AUTOPROXY_ALLOW_AUTOCONFIG
 Aktiviert die Proxyerkennung über die Autokonfigurations-URL.
 
Hinweis Unterstützung für dieses Flag wurde in Windows 10 Version 1703 (10.0; Build 15063).
 
WINHTTP_AUTOPROXY_ALLOW_CM
 Aktiviert die Proxyerkennung über den Verbindungs-Manager.
 
Hinweis Unterstützung für dieses Flag wurde in Windows 10 Version 1703 (10.0; Build 15063).
 
WINHTTP_AUTOPROXY_ALLOW_STATIC
 Aktiviert die Proxyerkennung über statische Konfiguration.
 
Hinweis Unterstützung für dieses Flag wurde in Windows 10 Version 1703 (10.0; Build 15063).
 
WINHTTP_AUTOPROXY_AUTO_DETECT
 Versuchen Sie, die URL der PAC-Datei mithilfe von DHCP- und DNS-Abfragen an das lokale Netzwerk automatisch zu ermitteln.
WINHTTP_AUTOPROXY_CONFIG_URL
 Laden Sie die PAC-Datei von der URL herunter, die von lpszAutoConfigUrl in der WINHTTP_AUTOPROXY_OPTIONS-Struktur angegeben wurde.
WINHTTP_AUTOPROXY_HOST_KEEPCASE
 Behält den Fall der Hostnamen bei, die an das PAC-Skript übergeben werden. Dies ist das Standardverhalten.
WINHTTP_AUTOPROXY_HOST_LOWERCASE
 Konvertiert Hostnamen in Kleinbuchstaben, bevor sie an das PAC-Skript übergeben werden.
WINHTTP_AUTOPROXY_NO_CACHE_CLIENT
 Deaktiviert das Abfragen eines Hosts in den Proxycache der Skriptausführungsergebnisse im aktuellen Prozess.
WINHTTP_AUTOPROXY_NO_CACHE_SVC
 Deaktiviert das Abfragen eines Hosts in den Proxycache der Skriptausführungsergebnisse im Autoproxydienst.
WINHTTP_AUTOPROXY_NO_DIRECTACCESS
 Deaktiviert das Abfragen von Direct Access-Proxyeinstellungen für diese Anforderung.
WINHTTP_AUTOPROXY_RUN_INPROCESS
 Führt das WPAD-Protokoll (Auto-Discovery) des Webproxys im Prozess aus, anstatt an einen out-of-process WinHTTP AutoProxy Service zu delegieren, sofern verfügbar. Dieses Flag muss mit einem der anderen Flags kombiniert werden.

Diese Option hat keine Auswirkungen, wenn sie an WinHttpGetProxyForUrlEx übergeben wird.

Hinweis Dieses Flag ist veraltet.
 
WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY
 Standardmäßig ist WinHTTP so konfiguriert, dass es auf die automatische Erkennung eines Proxys im Prozess zurückfällt. Wenn dieses Fallbackverhalten für den Fallback nicht wünschenswert ist, wenn eine Out-of-Process-Ermittlung fehlschlägt, kann es mithilfe dieses Flags deaktiviert werden.

Diese Option hat keine Auswirkungen, wenn sie an WinHttpGetProxyForUrlEx übergeben wird.

Hinweis Dieses Flag ist nur unter Windows Server 2003 verfügbar.
 
WINHTTP_AUTOPROXY_SORT_RESULTS
Sortiert die Proxyergebnisse basierend auf einer heuristischen Platzierung der schnellsten Proxys an erster Stelle.

dwAutoDetectFlags

Wenn dwFlags das WINHTTP_AUTOPROXY_AUTO_DETECT-Flag enthält, gibt dwAutoDetectFlags an, welche Protokolle zum Suchen der PAC-Datei verwendet werden sollen. Wenn sowohl die DHCP- als auch die DNS-Flags für die automatische Erkennung angegeben werden, wird zuerst DHCP verwendet. wenn keine PAC-URL mithilfe von DHCP ermittelt wird, wird DNS verwendet.

Wenn dwFlags das flag WINHTTP_AUTOPROXY_AUTO_DETECT nicht enthält, muss dwAutoDetectFlags 0 sein.

Wert Bedeutung
WINHTTP_AUTO_DETECT_TYPE_DHCP
 Verwenden Sie DHCP, um die Proxy-Autokonfigurationsdatei zu suchen.
WINHTTP_AUTO_DETECT_TYPE_DNS_A
 Verwenden Sie DNS, um zu versuchen, die Proxy-Autokonfigurationsdatei an einem bekannten Speicherort in der Domäne des lokalen Computers zu suchen.

lpszAutoConfigUrl

Wenn dwFlags das WINHTTP_AUTOPROXY_CONFIG_URL-Flag enthält, muss lpszAutoConfigUrl auf eine Unicode-Zeichenfolge mit Null-Beendigung zeigen, die die URL der PAC-Datei (Proxy Auto-Configuration) enthält.

Wenn dwFlags das flag WINHTTP_AUTOPROXY_CONFIG_URL nicht enthält, muss lpszAutoConfigUrlNULL sein.

lpvReserved

Reserviert für zukünftige Verwendung; muss NULL sein.

dwReserved

Für die zukünftige Verwendung reserviert. Muss 0 (null) sein.

fAutoLogonIfChallenged

Gibt an, ob die Domänenanmeldeinformationen des Clients automatisch als Reaktion auf eine NTLM- oder Verhandlungsauthentifizierungsanforderung gesendet werden sollen, wenn WinHTTP die PAC-Datei anfordert.

Wenn dieses Flag TRUE ist, sollten die Anmeldeinformationen automatisch als Reaktion auf eine Authentifizierungsanforderung gesendet werden. Wenn dieses Flag FALSE ist und die Authentifizierung zum Herunterladen der PAC-Datei erforderlich ist, schlägt die WinHttpGetProxyForUrl-Funktion fehl.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Kopfzeile winhttp.h

Weitere Informationen

WinHTTP-Versionen