WinHttpDetectAutoProxyConfigUrl, fonction (winhttp.h)

Article
08/27/2023

La fonction WinHttpDetectAutoProxyConfigUrl recherche l’URL du fichier PAC (Proxy Auto-Configuration). Cette fonction indique l’URL du fichier PAC, mais elle ne télécharge pas le fichier.

Syntaxe

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

Paramètres

[in] dwAutoDetectFlags

Type de données qui spécifie les protocoles à utiliser pour localiser le fichier PAC. Si les indicateurs de détection automatique DHCP et DNS sont définis, DHCP est utilisé en premier ; si aucune URL PAC n’est découverte à l’aide du protocole DHCP, DNS est utilisé.

Valeur	Signification
WINHTTP_AUTO_DETECT_TYPE_DHCP	Utilisez DHCP pour localiser le fichier de configuration automatique du proxy.
WINHTTP_AUTO_DETECT_TYPE_DNS_A	Utilisez DNS pour tenter de localiser le fichier de configuration automatique du proxy à un emplacement bien connu sur le domaine de l’ordinateur local.

[out] ppwstrAutoConfigUrl

Type de données qui retourne un pointeur vers une chaîne Unicode terminée par null qui contient l’URL de configuration qui reçoit les données proxy. Vous devez libérer la chaîne pointée par ppwszAutoConfigUrl à l’aide de la fonction GlobalFree .

Valeur retournée

Retourne TRUE en cas de réussite, ou FALSE dans le cas contraire. Pour obtenir des informations d’erreur étendues, appelez GetLastError. Parmi les codes d’erreur retournés figurent les suivants.

Code d'erreur	Description
ERROR_WINHTTP_AUTODETECTION_FAILED	Retourné si WinHTTP n’a pas pu découvrir l’URL du fichier PAC (Proxy Auto-Configuration).
ERROR_WINHTTP_INTERNAL_ERROR	Une erreur interne s'est produite.
ERROR_NOT_ENOUGH_MEMORY	La mémoire disponible était insuffisante pour terminer l’opération demandée. (Code d’erreur Windows)

Remarques

WinHTTP implémente le protocole WPAD (Web Proxy Auto-Discovery), souvent appelé autoproxy. Pour plus d’informations sur les emplacements connus, consultez la section Processus de découverte du document du protocole WPAD.

Notez que, étant donné que la fonction WinHttpDetectAutoProxyConfigUrl prend du temps pour terminer son opération, elle ne doit pas être appelée à partir d’un thread d’interface utilisateur.

Configuration requise


Client minimal pris en charge	Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winhttp.h
Bibliothèque	Winhttp.lib
DLL	Winhttp.dll

Voir aussi

WinHTTP Versions

Partager via