Partager via

WINHTTP_AUTOPROXY_OPTIONS structure (winhttp.h)

  • Article

La structure WINHTTP_AUTOPROXY_OPTIONS est utilisée pour indiquer à la fonction WinHttpGetProxyForURL s’il faut spécifier l’URL du fichier PAC (Proxy Auto-Configuration) ou localiser automatiquement l’URL avec des requêtes DHCP ou DNS sur le réseau.

Syntaxe

typedef struct _WINHTTP_AUTOPROXY_OPTIONS {
  DWORD   dwFlags;
  DWORD   dwAutoDetectFlags;
  LPCWSTR lpszAutoConfigUrl;
  LPVOID  lpvReserved;
  DWORD   dwReserved;
  BOOL    fAutoLogonIfChallenged;
} WINHTTP_AUTOPROXY_OPTIONS, *PWINHTTP_AUTOPROXY_OPTIONS;

Membres

dwFlags

Des mécanismes doivent être utilisés pour obtenir le fichier PAC.

Valeur Signification
WINHTTP_AUTOPROXY_ALLOW_AUTOCONFIG
 Active la détection de proxy via l’URL de configuration automatique.
 
Note La prise en charge de cet indicateur a été introduite dans Windows 10, version 1703 (10.0 ; Build 15063).
 
WINHTTP_AUTOPROXY_ALLOW_CM
 Active la détection de proxy via le gestionnaire de connexions.
 
Note La prise en charge de cet indicateur a été introduite dans Windows 10, version 1703 (10.0 ; Build 15063).
 
WINHTTP_AUTOPROXY_ALLOW_STATIC
 Active la détection de proxy via une configuration statique.
 
Note La prise en charge de cet indicateur a été introduite dans Windows 10, version 1703 (10.0 ; Build 15063).
 
WINHTTP_AUTOPROXY_AUTO_DETECT
 Essayez de découvrir automatiquement l’URL du fichier PAC à l’aide de requêtes DHCP et DNS sur le réseau local.
WINHTTP_AUTOPROXY_CONFIG_URL
 Téléchargez le fichier PAC à partir de l’URL spécifiée par lpszAutoConfigUrl dans la structure WINHTTP_AUTOPROXY_OPTIONS .
WINHTTP_AUTOPROXY_HOST_KEEPCASE
 Conserve la casse des noms d’hôte passés au script PAC. Il s'agit du comportement par défaut.
WINHTTP_AUTOPROXY_HOST_LOWERCASE
 Convertit les noms d’hôte en minuscules avant de les transmettre au script PAC.
WINHTTP_AUTOPROXY_NO_CACHE_CLIENT
 Désactive l’interrogation d’un hôte vers le cache proxy des résultats d’exécution de script dans le processus actuel.
WINHTTP_AUTOPROXY_NO_CACHE_SVC
 Désactive l’interrogation d’un hôte vers le cache proxy des résultats d’exécution de script dans le service autoproxy.
WINHTTP_AUTOPROXY_NO_DIRECTACCESS
 Désactive l’interrogation des paramètres de proxy d’accès direct pour cette requête.
WINHTTP_AUTOPROXY_RUN_INPROCESS
 Exécute le protocole WPAD (Web Proxy Auto-Discovery) in-process au lieu de déléguer à un service WinHTTP AutoProxy hors processus, si disponible. Cet indicateur doit être combiné avec l’un des autres indicateurs.

Cette option n’a aucun effet lorsqu’elle est passée à WinHttpGetProxyForUrlEx.

Note Cet indicateur est déconseillé.
 
WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY
 Par défaut, WinHTTP est configuré pour revenir à la découverte automatique d’un proxy in-process. Si ce comportement de secours n’est pas souhaitable en cas d’échec d’une découverte hors processus, il peut être désactivé à l’aide de cet indicateur.

Cette option n’a aucun effet lorsqu’elle est passée à WinHttpGetProxyForUrlEx.

Note Cet indicateur est disponible uniquement sur Windows Server 2003.
 
WINHTTP_AUTOPROXY_SORT_RESULTS
Classe les résultats du proxy en fonction d’une heuristique plaçant en premier les proxys les plus rapides.

dwAutoDetectFlags

Si dwFlags inclut l’indicateur WINHTTP_AUTOPROXY_AUTO_DETECT, dwAutoDetectFlags spécifie les protocoles à utiliser pour localiser le fichier PAC. Si les indicateurs de détection automatique DHCP et DNS sont spécifiés, dhcp est utilisé en premier ; si aucune URL PAC n’est découverte à l’aide du protocole DHCP, DNS est utilisé.

Si dwFlags n’inclut pas l’indicateur WINHTTP_AUTOPROXY_AUTO_DETECT, dwAutoDetectFlags doit être égal à zéro.

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.

lpszAutoConfigUrl

Si dwFlags inclut l’indicateur de WINHTTP_AUTOPROXY_CONFIG_URL, lpszAutoConfigUrl doit pointer vers une chaîne Unicode terminée par null qui contient l’URL du fichier pac (proxy auto-configuration).

Si dwFlags n’inclut pas l’indicateur WINHTTP_AUTOPROXY_CONFIG_URL, lpszAutoConfigUrl doit avoir la valeur NULL.

lpvReserved

Réservé pour une utilisation ultérieure ; doit être NULL.

dwReserved

Réservé pour une future utilisation ; doit être nul.

fAutoLogonIfChallenged

Spécifie si les informations d’identification de domaine du client doivent être envoyées automatiquement en réponse à un défi NTLM ou Negotiate Authentication lorsque WinHTTP demande le fichier PAC.

Si cet indicateur a la valeur TRUE, les informations d’identification doivent être envoyées automatiquement en réponse à une demande d’authentification. Si cet indicateur a la valeur FALSE et que l’authentification est requise pour télécharger le fichier PAC, la fonction WinHttpGetProxyForUrl échoue.

Configuration requise

Condition requise Valeur
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]
En-tête winhttp.h

Voir aussi

WinHTTP Versions