Partager via

INTERNET_PER_CONN_OPTIONA structure (wininet.h)

  • Article

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 Value contient une ou plusieurs des valeurs suivantes :
AUTO_PROXY_FLAG_ALWAYS_DETECT
Toujours détecter 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 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 Value 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
 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 Value 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 d’InternetQueryOption et InternetSetOption fonctionnent avec la structure INTERNET_PER_CONN_OPTION. Les versions Unicode prendront 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.

Note 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).
 

Notes

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. La combinaison 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête wininet.h

Voir aussi

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption

InternetSetOption