WinHttpDetectAutoProxyConfigUrl-Funktion (winhttp.h)

  • Artikel
  • 2 Minuten Lesedauer

Die WinHttpDetectAutoProxyConfigUrl-Funktion findet die URL für die Proxy-Autokonfigurationsdatei (PAC). Diese Funktion meldet die URL der PAC-Datei, lädt die Datei jedoch nicht herunter.

Syntax

WINHTTPAPI BOOL WinHttpDetectAutoProxyConfigUrl(
  [in]  DWORD  dwAutoDetectFlags,
  [out] LPWSTR *ppwstrAutoConfigUrl
);

Parameter

[in] dwAutoDetectFlags

Ein Datentyp, der angibt, welche Protokolle zum Suchen der PAC-Datei verwendet werden sollen. Wenn sowohl die DHCP- als auch die DNS-Automatischerkennungs-Flags festgelegt sind, wird DHCP zuerst verwendet; wenn keine PAC-URL mithilfe von DHCP erkannt wird, wird DNS verwendet.

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

[out] ppwstrAutoConfigUrl

Ein Datentyp, der einen Zeiger auf eine null-beendete Unicode-Zeichenfolge zurückgibt, die die Konfigurations-URL enthält, die die Proxydaten empfängt. Sie müssen die Zeichenfolge frei geben, die von ppwszAutoConfigUrl mit der GlobalFree-Funktion angezeigt wird.

Rückgabewert

Gibt TRUE zurück, wenn es erfolgreich ist oder FALSCH andernfalls. Rufen Sie getLastError für erweiterte Fehlerinformationen auf. Unter den zurückgegebenen Fehlercodes sind die folgenden.

Fehlercode BESCHREIBUNG
ERROR_WINHTTP_AUTODETECTION_FAILED
 Zurückgegeben, wenn WinHTTP die URL der Proxy-Autokonfigurationsdatei (PAC) nicht ermitteln konnte.
ERROR_WINHTTP_INTERNAL_ERROR
 Ein interner Fehler ist aufgetreten.
ERROR_NOT_ENOUGH_MEMORY
 Nicht genügend Arbeitsspeicher war verfügbar, um den angeforderten Vorgang abzuschließen. (Windows-Fehlercode)

Bemerkungen

WinHTTP implementiert das Webproxy-Auto-Discovery -Protokoll (WPAD), das häufig als Autoproxy bezeichnet wird. Weitere Informationen zu bekannten Speicherorten finden Sie im Abschnitt " Discovery Process " des WPAD-Protokolldokuments.

Beachten Sie, dass die WinHttpDetectAutoProxyConfigUrl-Funktion Zeit benötigt, um den Vorgang abzuschließen, sollte sie nicht aus einem UI-Thread aufgerufen werden.

Anforderungen

   
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]
Zielplattform Windows
Kopfzeile winhttp.h
Bibliothek Winhttp.lib
DLL Winhttp.dll

Weitere Informationen

WinHTTP-Versionen