WinHttpDetectAutoProxyConfigUrl-Funktion (winhttp.h)

Artikel
08/27/2023

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.

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.

[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
ERROR_WINHTTP_AUTODETECTION_FAILED	Wird zurückgegeben, wenn WinHTTP die URL der PAC-Datei (Proxy Auto-Configuration) nicht ermitteln konnte.
ERROR_WINHTTP_INTERNAL_ERROR	Ein interner Fehler ist aufgetreten.
ERROR_NOT_ENOUGH_MEMORY	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

Weitere Informationen

WinHTTP-Versionen

Freigeben über