WinHttpDetectAutoProxyConfigUrl-Funktion (winhttp.h)
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.
[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 |
---|---|
|
Zurückgegeben, wenn WinHTTP die URL der Proxy-Autokonfigurationsdatei (PAC) nicht ermitteln konnte. |
|
Ein interner Fehler ist aufgetreten. |
|
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 |