WinHttpDetectAutoProxyConfigUrl, fonction (winhttp.h)

  • Article

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