Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die WinHttpDetectAutoProxyConfigUrl-Funktion sucht die URL für die PAC-Datei (Proxy Auto-Configuration). 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 das DHCP- als auch das DNS-Flag für die automatische Erkennung festgelegt sind, wird zuerst DHCP verwendet. Wenn keine PAC-URL mithilfe von DHCP ermittelt wird, wird DNS verwendet.
[out] ppwstrAutoConfigUrl
Ein Datentyp, der einen Zeiger auf eine unicode-Zeichenfolge mit NULL-Termin zurückgibt, die die Konfigurations-URL enthält, die die Proxydaten empfängt. Sie müssen die Zeichenfolge, auf die ppwszAutoConfigUrl verweist, mithilfe der GlobalFree-Funktion freigeben.
Rückgabewert
Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE . Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten. Zu den zurückgegebenen Fehlercodes gehören die folgenden.
Fehlercode | BESCHREIBUNG |
---|---|
|
Wird zurückgegeben, wenn WinHTTP die URL der PAC-Datei (Proxy Auto-Configuration) nicht ermitteln konnte. |
|
Ein interner Fehler ist aufgetreten. |
|
Es war nicht genügend Arbeitsspeicher verfügbar, um den angeforderten Vorgang abzuschließen. (Windows-Fehlercode) |
Hinweise
WinHTTP implementiert das WPAD-Protokoll (Web Proxy Auto-Discovery), das häufig als Autoproxy bezeichnet wird. Weitere Informationen zu bekannten Speicherorten finden Sie im Abschnitt Ermittlungsprozess des WPAD-Protokolldokuments.
Beachten Sie, dass die WinHttpDetectAutoProxyConfigUrl-Funktion nicht von einem UI-Thread aufgerufen werden sollte, da die WinHttpDetectAutoProxyConfigUrl-Funktion zeit braucht, um ihren Vorgang abzuschließen.
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 |