WinHttpDetectAutoProxyConfigUrl, fonction (winhttp.h)
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.
WINHTTPAPI BOOL WinHttpDetectAutoProxyConfigUrl(
[in] DWORD dwAutoDetectFlags,
[out] LPWSTR *ppwstrAutoConfigUrl
);
[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é.
[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 .
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 |
---|---|
|
Retourné si WinHTTP n’a pas pu découvrir l’URL du fichier PAC (Proxy Auto-Configuration). |
|
Une erreur interne s'est produite. |
|
La mémoire disponible était insuffisante pour terminer l’opération demandée. (Code d’erreur Windows) |
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.
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 |