structure INTERNET_PER_CONN_OPTIONA (wininet.h)

Contient la valeur d’une option.

Syntaxe

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPSTR    pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONA, *LPINTERNET_PER_CONN_OPTIONA;

Membres

dwOption

Option à interroger ou définir. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
INTERNET_PER_CONN_AUTOCONFIG_URL	Définit ou récupère une chaîne contenant l’URL du script de configuration automatique.
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS	Définit ou récupère les paramètres de découverte automatique. Le membre Valeur contient une ou plusieurs des valeurs suivantes : AUTO_PROXY_FLAG_ALWAYS_DETECT Détectez toujours automatiquement les paramètres. AUTO_PROXY_FLAG_CACHE_INIT_RUN Indique que les résultats mis en cache du script de configuration de proxy automatique doivent être utilisés, au lieu d’exécuter réellement le script, sauf si le fichier mis en cache a expiré. AUTO_PROXY_FLAG_DETECTION_RUN La détection automatique a été exécutée au moins une fois sur cette connexion. AUTO_PROXY_FLAG_DETECTION_SUSPECT Non pris en charge actuellement. AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT N’autorisez pas la mise en cache du résultat du script de configuration de proxy automatique. AUTO_PROXY_FLAG_MIGRATED Le paramètre a été migré à partir d’une installation de Microsoft Internet Explorer 4.0 et la détection automatique doit être tentée une seule fois. AUTO_PROXY_FLAG_USER_SET L’utilisateur a explicitement défini la détection automatique.
INTERNET_PER_CONN_FLAGS	Définit ou récupère le type de connexion. Le membre Valeur contient une ou plusieurs des valeurs suivantes : PROXY_TYPE_DIRECT La connexion n’utilise pas de serveur proxy. PROXY_TYPE_PROXY La connexion utilise un serveur proxy défini explicitement. PROXY_TYPE_AUTO_PROXY_URL La connexion télécharge et traite un script de configuration automatique à une URL spécifiée. PROXY_TYPE_AUTO_DETECT La connexion détecte automatiquement les paramètres.
INTERNET_PER_CONN_PROXY_BYPASS	Définit ou récupère une chaîne contenant les URL qui n’utilisent pas le serveur proxy.
INTERNET_PER_CONN_PROXY_SERVER	Définit ou récupère une chaîne contenant les serveurs proxy.
INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL	URL de configuration automatique chaînée. Utilisé lorsque l’URL de configuration automatique principale pointe vers un fichier INS qui définit une deuxième URL de configuration automatique pour les informations de proxy.
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS	de minutes jusqu’à l’actualisation automatique de l’URL de configuration automatique par découverte automatique.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME	Option En lecture seule. Retourne l’heure à laquelle la dernière URL de configuration automatique correcte connue a été trouvée à l’aide de la découverte automatique.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL	Option En lecture seule. Retourne la dernière URL correcte connue trouvée à l’aide de la découverte automatique.

 

Windows 7 et versions ultérieures :

Les clients qui prennent en charge Internet Explorer 8 doivent interroger le type de connexion à l’aide de INTERNET_PER_CONN_FLAGS_UI. Si cette requête échoue, le système exécute une version précédente d’Internet Explorer et le client doit interroger à nouveau avec INTERNET_PER_CONN_FLAGS.

Restaurez le type de connexion à l’aide de INTERNET_PER_CONN_FLAGS quelle que soit la version d’Internet Explorer.

Valeur

Signification

INTERNET_PER_CONN_FLAGS_UI

Définit ou récupère le type de connexion. Le membre Valeur contient une ou plusieurs des valeurs suivantes : PROXY_TYPE_DIRECT La connexion n’utilise pas de serveur proxy. PROXY_TYPE_PROXY La connexion utilise un serveur proxy défini explicitement. PROXY_TYPE_AUTO_PROXY_URL La connexion télécharge et traite un script de configuration automatique à une URL spécifiée. PROXY_TYPE_AUTO_DETECT La connexion détecte automatiquement les paramètres.

Value

Union qui contient la valeur de l’option. Il peut s’agir de l’un des types suivants en fonction de la valeur de dwOption:

dwValue

Valeur entière longue non signée.

pszValue

Pointeur vers une valeur de chaîne.

ftValue

Structure FILETIME.

Value.dwValue

Value.pszValue

Value.ftValue

Remarques

Dans Internet Explorer 5, seules les versions ANSI de InternetQueryOption et InternetSetOption fonctionnent avec la structure INTERNET_PER_CONN_OPTION. Les versions Unicode prennent en charge la structure INTERNET_PER_CONN_OPTION dans les versions ultérieures d’Internet Explorer.

Pour les requêtes qui retournent des chaînes, InternetQueryOption alloue la mémoire pour le membre pszValue de la structure. L’application appelante doit libérer cette mémoire à l’aide de la fonction GlobalFree lorsqu’elle a terminé d’utiliser la chaîne.

Remarque WinINet ne prend pas en charge les implémentations de serveur. En outre, il ne doit pas être utilisé à partir d’un service. Pour les implémentations de serveur ou les services, utilisez Microsoft Windows HTTP Services (WinHTTP).

 

Note

L’en-tête wininet.h définit INTERNET_PER_CONN_OPTION en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	wininet.h

Voir aussi

INTERNET_PER_CONN_OPTION_LIST

internetQueryOption

internetSetOption