Indicateurs d’option (Wininet.h)

Les indicateurs d’option suivants sont utilisés avec les fonctions InternetQueryOption et InternetSetOption . Tous les indicateurs d’option valides ont une valeur supérieure ou égale à INTERNET_FIRST_OPTION et inférieure ou égale à INTERNET_LAST_OPTION.

INTERNET_OPTION_ALTER_IDENTITY

80

Non implémenté

INTERNET_OPTION_ASYNC

30

Non implémenté.

INTERNET_OPTION_ASYNC_ID

15

Non implémenté.

INTERNET_OPTION_ASYNC_PRIORITY

16

Non implémenté.

INTERNET_OPTION_BYPASS_EDITED_ENTRY

64

Définit ou récupère la valeur booléenne qui détermine si le système doit case activée le réseau pour le contenu plus récent et remplacer les entrées de cache modifiées si une version plus récente est trouvée. Si la valeur est True, le système recherche sur le réseau du contenu plus récent et remplace l’entrée de cache modifiée par la version la plus récente. La valeur par défaut est False, ce qui indique que l’entrée de cache modifiée doit être utilisée sans vérifier le réseau. Elle est utilisée par InternetQueryOption et InternetSetOption. Elle est valide uniquement dans Microsoft Internet Explorer 5 et versions ultérieures.

INTERNET_OPTION_CACHE_STREAM_HANDLE

27

N'est plus pris en charge.

INTERNET_OPTION_CACHE_TIMESTAMPS

69

Récupère une structure de INTERNET_CACHE_TIMESTAMPS qui contient l’heure LastModified et l’heure d’expiration à partir de la ressource stockée dans le cache Internet. Cette valeur est utilisée par InternetQueryOption.

INTERNET_OPTION_CALLBACK

1

Définit ou récupère l’adresse de la fonction de rappel définie pour ce handle. Cette option peut être utilisée sur tous les handles HINTERNET . Utilisé par InternetQueryOption et InternetSetOption.

INTERNET_OPTION_CALLBACK_FILTER

54

Non implémenté.

INTERNET_OPTION_CLIENT_CERT_CONTEXT

84

Cet indicateur n’est pas pris en charge par InternetQueryOption. Le paramètre lpBuffer doit être un pointeur vers une structure CERT_CONTEXT et non un pointeur vers un pointeur CERT_CONTEXT . Si une application reçoit ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED, elle doit appeler InternetErrorDlg ou utiliser InternetSetOption pour fournir un certificat avant de réessayer la demande. CertDuplicateCertificateContext est ensuite appelé afin que le contexte de certificat passé puisse être libéré indépendamment par l’application.

INTERNET_OPTION_CODEPAGE

68

Par défaut, la partie hôte ou autorité de l’URL Unicode est encodée selon la spécification IDN. Lorsque l’IDN est désactivé, cette option est définie sur la requête ou sur le handle de connexion, spécifie un schéma d’encodage de page de codes pour la partie hôte de l’URL. Le paramètre lpBuffer dans l’appel à InternetSetOption contient la page de codes DBCS souhaitée. Si aucune page de codes n’est spécifiée dans lpBuffer, WinINet utilise la page de codes système par défaut (CP_ACP). Remarque : cette option est ignorée si IDN n’est pas désactivé. Pour plus d’informations sur la désactivation de l’IDN, consultez l’option INTERNET_OPTION_IDN .

Windows XP avec SP2 et Windows Server 2003 avec SP1 : Cet indicateur n’est pas pris en charge.

Version: Nécessite Internet Explorer 7.0.

INTERNET_OPTION_CODEPAGE_PATH

100

Par défaut, la partie chemin d’accès de l’URL est encodée en UTF8. L’API WinINet effectue l’encodage en caractères d’échappement (%) sur les caractères de bits élevés. La définition de cette option sur la requête, ou le handle de connexion, désactive l’encodage UTF8 et définit une page de codes spécifique. Le paramètre lpBuffer dans l’appel à InternetSetOption contient la page de code DBCS souhaitée pour le chemin d’accès. Si aucune page de codes n’est spécifiée dans lpBuffer, WinINet utilise la CP_UTF8 par défaut.

Windows XP avec SP2 et Windows Server 2003 avec SP1 : Cet indicateur n’est pas pris en charge.

Version: Nécessite Internet Explorer 7.0.

INTERNET_OPTION_CODEPAGE_EXTRA

101

Par défaut, la partie chemin d’accès de l’URL est la page de codes système par défaut (CP_ACP). Les conversions du caractère d’échappement (%) ne sont pas effectuées sur la partie supplémentaire. La définition de cette option sur la demande ou le handle de connexion désactive l’encodage CP_ACP. Le paramètre lpBuffer dans l’appel à InternetSetOption contient la page de codes DBCS souhaitée pour la partie supplémentaire de l’URL. Si aucune page de codes n’est spécifiée dans lpBuffer, WinINet utilise la page de codes système par défaut (CP_ACP).

Windows XP avec SP2 et Windows Server 2003 avec SP1 : Cet indicateur n’est pas pris en charge.

Version: Nécessite Internet Explorer 7.0.

INTERNET_OPTION_COMPRESSED_CONTENT_LENGTH

147

Pour une requête dans laquelle WinInet a décompressé l’encodage de contenu fourni par le serveur, récupère le content-length signalé par le serveur du corps de la réponse en tant qu’ULONGLONG. Pris en charge dans Windows 10, version 1507 et ultérieures.

INTERNET_OPTION_CONNECT_BACKOFF

4

Non implémenté.

INTERNET_OPTION_CONNECT_RETRIES

3

Définit ou récupère une valeur entière longue non signée qui contient le nombre de tentatives de résolution et de connexion à un hôte par WinINet. Il ne tente qu’une seule fois par adresse IP. Par exemple, si vous tentez de vous connecter à un hôte multi-hébergement qui a dix adresses IP et que INTERNET_OPTION_CONNECT_RETRIES est défini sur sept, WinINet tente uniquement de résoudre et de se connecter aux sept premières adresses IP. À l’inverse, étant donné le même ensemble de dix adresses IP, si INTERNET_OPTION_CONNECT_RETRIES est défini sur 20, WinINet n’essaie chacune des dix adresses IP qu’une seule fois. Si un hôte n’a qu’une seule adresse IP et que la première tentative de connexion échoue, il n’y a pas d’autres tentatives. Si une tentative de connexion échoue toujours après le nombre spécifié de tentatives, la demande est annulée. La valeur par défaut de INTERNET_OPTION_CONNECT_RETRIES est de cinq tentatives. Cette option peut être utilisée sur n’importe quel handle HINTERNET , y compris un handle NULL . Il est utilisé par InternetQueryOption et InternetSetOption.

INTERNET_OPTION_CONNECT_TIME

55

Non implémenté.

INTERNET_OPTION_CONNECT_TIMEOUT

2

Définit ou récupère une valeur entière longue non signée qui contient la valeur de délai d’attente, en millisecondes, à utiliser pour les demandes de connexion Internet. La définition de cette option sur infini (0xFFFFFFFF) désactive ce minuteur.

Si une demande de connexion prend plus de temps que cette valeur de délai d’attente, la demande est annulée. Lorsque vous tentez de vous connecter à plusieurs adresses IP pour un hôte unique (hôte multi-accueil), la limite de délai d’attente est cumulative pour toutes les adresses IP. Cette option peut être utilisée sur n’importe quel handle HINTERNET , y compris un handle NULL . Il est utilisé par InternetQueryOption et InternetSetOption.

INTERNET_OPTION_CONNECTED_STATE

50

Définit ou récupère une valeur entière longue non signée qui contient l’état connecté. Il est utilisé par InternetQueryOption et InternetSetOption.

INTERNET_OPTION_CONTEXT_VALUE

45

Définit ou récupère une DWORD_PTR qui contient l’adresse de la valeur de contexte associée à ce handle HINTERNET . Cette option peut être utilisée sur n’importe quel handle HINTERNET . Il est utilisé par InternetQueryOption et InternetSetOption. Auparavant, cela définissait la valeur de contexte sur l’adresse stockée dans le pointeur lpBuffer . Cela a été corrigé afin que la valeur stockée dans la mémoire tampon soit utilisée et qu’une nouvelle valeur soit attribuée à l’indicateur INTERNET_OPTION_CONTEXT_VALUE . L’ancienne valeur 10 a été conservée afin que les applications écrites pour l’ancien comportement soient toujours prises en charge.

INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT

6

Identique à INTERNET_OPTION_RECEIVE_TIMEOUT. Il est utilisé par InternetQueryOption et InternetSetOption.

INTERNET_OPTION_CONTROL_SEND_TIMEOUT

5

Identique à INTERNET_OPTION_SEND_TIMEOUT. Il est utilisé par InternetQueryOption et InternetSetOption.

INTERNET_OPTION_DATA_RECEIVE_TIMEOUT

8

Définit ou récupère une valeur entière longue non signée qui contient la valeur de délai d’attente, en millisecondes, pour recevoir une réponse à une demande pour le canal de données d’une transaction FTP. Si la réponse prend plus de temps que cette valeur de délai d’attente, la demande est annulée. Cette option peut être utilisée sur n’importe quel handle HINTERNET , y compris un handle NULL . Il est utilisé par InternetQueryOption et InternetSetOption.

Cet indicateur n’a aucun impact sur les fonctionnalités HTTP.

INTERNET_OPTION_DATA_SEND_TIMEOUT

7

Définit ou récupère une valeur entière longue non signée, en millisecondes, qui contient la valeur de délai d’attente pour envoyer une requête pour le canal de données d’une transaction FTP. Si l’envoi prend plus de temps que cette valeur de délai d’attente, l’envoi est annulé. Cette option peut être utilisée sur n’importe quel handle HINTERNET , y compris un handle NULL . Il est utilisé par InternetQueryOption et InternetSetOption.

Cet indicateur n’a aucun impact sur les fonctionnalités HTTP.

INTERNET_OPTION_DATAFILE_NAME

33

Récupère une valeur de chaîne qui contient le nom du fichier qui contient une entité téléchargée. Cet indicateur est valide une fois InternetOpenUrl, FtpOpenFile, GopherOpenFile ou HttpOpenRequest terminé. Cette option peut uniquement être interrogée par InternetQueryOption.

INTERNET_OPTION_DATAFILE_EXT

96

Définit une valeur de chaîne qui contient l’extension du fichier qui contient une entité téléchargée. Cet indicateur doit être défini avant d’appeler InternetOpenUrl, FtpOpenFile, GopherOpenFile ou HttpOpenRequest. Cette option ne peut être définie que par InternetSetOption.

INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO

67

Récupère une structure INTERNET_DIAGNOSTIC_SOCKET_INFO qui contient des données sur une requête HTTP spécifiée. Cet indicateur est utilisé par InternetQueryOption.

Windows 7 : Cette option n’est plus prise en charge.

INTERNET_OPTION_DIGEST_AUTH_UNLOAD

76

Provoque la déconnexion du système du package SSPI d’authentification Digest, en purgeant toutes les informations d’identification créées pour le processus. Aucune mémoire tampon n’est requise pour cette option. Il est utilisé par InternetSetOption.

INTERNET_OPTION_DISABLE_AUTODIAL

70

Non implémenté.

INTERNET_OPTION_DISCONNECTED_TIMEOUT

49

Non implémenté.

INTERNET_OPTION_ENABLE_HTTP_PROTOCOL

148

Définit un masque de bits DWORD de versions HTTP avancées acceptables. Peut être défini sur n’importe quel type de handle. Les valeurs possibles sont les suivantes :

• HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Pris en charge sur Windows 10, version 1507 et ultérieure.

Les versions héritées de HTTP (1.1 et antérieures) ne peuvent pas être désactivées à l’aide de cette option. La valeur par défaut est 0x0. Pris en charge dans Windows 10, version 1507 et ultérieure.

INTERNET_OPTION_ENABLE_REDIRECT_CACHE_READ

122

Sur un handle de requête, définit une valeur booléenne qui contrôle si les redirections seront retournées à partir du cache WinInet pour une demande donnée. La valeur par défaut est FALSE. Pris en charge dans Windows 8 et versions ultérieures.

INTERNET_OPTION_ENCODE_EXTRA

155

Obtient/définit un BOOL indiquant si les caractères non ASCII de la chaîne de requête doivent être encodés en pourcentage. La valeur par défaut est FALSE. Pris en charge dans Windows 8.1 et versions ultérieures.

INTERNET_OPTION_END_BROWSER_SESSION

42

Vide les entrées non utilisées du cache de mot de passe sur le disque dur. Réinitialise également l’heure du cache utilisée lorsque le mode de synchronisation est une fois par session. Aucune mémoire tampon n’est requise pour cette option. Il est utilisé par InternetSetOption.

INTERNET_OPTION_ERROR_MASK

62

Définit une valeur entière longue non signée qui contient les masques d’erreur qui peuvent être gérés par l’application cliente. Il peut s’agir d’une combinaison des valeurs suivantes :

INTERNET_ERROR_MASK_COMBINED_SEC_CERT

0x2

Indique que toutes les erreurs de certificat doivent être signalées à l’aide du même retour d’erreur, à savoir ERROR_INTERNET_SEC_CERT_ERRORS. Si cet indicateur est défini, appelez InternetErrorDlg à la réception de l’erreur ERROR_INTERNET_SEC_CERT_ERRORS , afin que l’utilisateur puisse répondre à une boîte de dialogue familière décrivant le problème.

Attention

Le fait de ne pas informer l’utilisateur de cette erreur expose l’utilisateur à des attaques potentielles d’usurpation d’identité.

INTERNET_ERROR_MASK_INSERT_CDROM

0x1

Indique que l’application cliente peut gérer le code d’erreur ERROR_INTERNET_INSERT_CDROM .

INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY

0x8

Indique que l’application cliente peut gérer le code d’erreur ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY .

INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG

0x4

Non implémenté.

INTERNET_OPTION_ENTERPRISE_CONTEXT

159

Définit un PWSTR contenant l’ID d’entreprise (voir https://msdn.microsoft.com/library/windows/desktop/mt759320(v=vs.85).aspx) qui s’applique à la demande. Pris en charge dans Windows 10, version 1507 et ultérieures.

INTERNET_OPTION_EXTENDED_ERROR

24

Récupère une valeur entière longue non signée qui contient un code d’erreur Winsock mappé au dernier ERROR_INTERNET_ messages d’erreur retournés dans ce contexte de thread. Cette option est utilisée sur un handle HINTERNETNULL par InternetQueryOption.

INTERNET_OPTION_FROM_CACHE_TIMEOUT

63

Définit ou récupère la valeur d’entier long non signé a1n qui contient la durée pendant laquelle le système doit attendre une réponse à une requête réseau avant de vérifier la copie de la ressource dans le cache. Si une requête réseau prend plus de temps que le temps spécifié et que la ressource demandée est disponible dans le cache, la ressource est récupérée à partir du cache. Elle est utilisée par InternetQueryOption et InternetSetOption.

INTERNET_OPTION_HANDLE_TYPE

9

Récupère une valeur entière longue non signée qui contient le type des handles HINTERNET passés. Il est utilisé par InternetQueryOption sur n’importe quel handle HINTERNET . Les valeurs de retour possibles sont les suivantes.

INTERNET_HANDLE_TYPE_CONNECT_FTP

2

INTERNET_HANDLE_TYPE_CONNECT_GOPHER

3

INTERNET_HANDLE_TYPE_CONNECT_HTTP

4

INTERNET_HANDLE_TYPE_FILE_REQUEST

14

INTERNET_HANDLE_TYPE_FTP_FILE

7

INTERNET_HANDLE_TYPE_FTP_FILE_HTML

8

INTERNET_HANDLE_TYPE_FTP_FIND

5

INTERNET_HANDLE_TYPE_FTP_FIND_HTML

6

INTERNET_HANDLE_TYPE_GOPHER_FILE

11

INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML

12

INTERNET_HANDLE_TYPE_GOPHER_FIND

9

INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML

10

INTERNET_HANDLE_TYPE_HTTP_REQUEST

13

INTERNET_HANDLE_TYPE_INTERNET

1

INTERNET_OPTION_HSTS

157

Obtient/définit un boOL indiquant si WinInet doit suivre les directives HTTP Strict Transport Security (HSTS) des serveurs. Si cette option est activée, https:// requêtes schématées vers des domaines pour lesquels une stratégie HSTS est mise en cache par WinInet sont redirigées vers des URL de https:// correspondantes. La valeur par défaut est FALSE. Pris en charge dans Windows 8.1 et versions ultérieures.

INTERNET_OPTION_HTTP_DECODING

65

Permet à WinINet d’effectuer le décodage pour les schémas d’encodage gzip et deflate. Pour plus d’informations, consultez Encodage de contenu.

INTERNET_OPTION_HTTP_PROTOCOL_USED

149

Obtient un DWORD indiquant quelle version HTTP avancée a été utilisée sur une requête donnée. Les valeurs possibles sont les suivantes :

• HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Pris en charge sur Windows 10, version 1507 et ultérieure.

0x0 indique HTTP/1.1 ou version antérieure ; consultez INTERNET_OPTION_HTTP_VERSION si vous avez besoin d’une plus grande précision quant à la version héritée utilisée. Pris en charge sur Windows 10, version 1507 et ultérieure.

INTERNET_OPTION_HTTP_VERSION

59

Définit ou récupère une structure HTTP_VERSION_INFO qui contient la version HTTP prise en charge. Cela doit être utilisé sur un handle NULL . Elle est utilisée par InternetQueryOption et InternetSetOption.

Sur Windows 7, Windows Server 2008 R2 et versions ultérieures, la valeur du membre dwMinorVersion dans la structure HTTP_VERSION_INFO est remplacée par les paramètres de Explorer Internet. EnableHttp1_1 est une valeur de Registre sous HKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE contrôlée par les options Internet définies dans Internet Explorer pour le système. La valeur EnableHttp1_1 est 1 par défaut. La structure HTTP_VERSION_INFO est ignorée pour toute version HTTP inférieure à 1.1 si EnableHttp1_1 a la valeur 1.

INTERNET_OPTION_IDENTITY

78

Non implémenté.

INTERNET_OPTION_IDLE_STATE

51

Non implémenté.

INTERNET_OPTION_IDN

102

Par défaut, la partie hôte ou autorité de l’URL est encodée selon la spécification IDN pour les connexions directes et proxy. Cette option peut être utilisée sur la demande ou le handle de connexion pour activer ou désactiver l’IDN. Lorsque l’IDN est désactivé, WinINet utilise la page de code système pour encoder la partie hôte ou autorité de l’URL. Pour désactiver la conversion de l’hôte IDN, définissez le paramètre lpBuffer dans l’appel à InternetSetOption sur zéro. Pour activer la conversion IDN uniquement sur la connexion directe, spécifiez INTERNET_FLAG_IDN_DIRECT dans le paramètre lpBuffer dans l’appel à InternetSetOption. Pour activer la conversion IDN uniquement sur la connexion proxy, spécifiez INTERNET_FLAG_IDN_PROXY dans le paramètre lpBuffer dans l’appel à InternetSetOption.

Windows XP avec SP2 et Windows Server 2003 avec SP1 : Cet indicateur n’est pas pris en charge.

Version: Nécessite Internet Explorer 7.0.

INTERNET_OPTION_IGNORE_OFFLINE

77

Définit ou récupère si l’indicateur hors connexion global doit être ignoré pour le handle de requête spécifié. Aucune mémoire tampon n’est requise pour cette option. Il est utilisé par InternetQueryOption et InternetSetOption avec un handle de requête. Cette option est valide uniquement dans Internet Explorer 5 et versions ultérieures.

INTERNET_OPTION_KEEP_CONNECTION

22

Non implémenté.

INTERNET_OPTION_LISTEN_TIMEOUT

11

Non implémenté.

INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER

74

Définit ou récupère une valeur entière longue non signée qui contient le nombre maximal de connexions autorisées par serveur HTTP/1.0. Il est utilisé par InternetQueryOption et InternetSetOption. Cette option est valide uniquement dans Internet Explorer 5 et versions ultérieures.

INTERNET_OPTION_MAX_CONNS_PER_PROXY

103

Définit ou récupère une valeur entière longue non signée qui contient le nombre maximal de connexions autorisées par proxy DU CERN. Lorsque cette option est définie ou récupérée, le paramètre hInternet doit définir sur une valeur de handle null . Une valeur de handle null indique que l’option doit être définie ou interrogée pour le processus en cours. Lors de l’appel d’InternetSetOption avec cette option, tous les objets proxy existants reçoivent la nouvelle valeur. Cette valeur est limitée à une plage comprise entre 2 et 128, inclus.

Version: Nécessite Internet Explorer 8.0.

INTERNET_OPTION_MAX_CONNS_PER_SERVER

73

Définit ou récupère une valeur entière longue non signée qui contient le nombre maximal de connexions autorisées par serveur. Il est utilisé par InternetQueryOption et InternetSetOption. Cette option est valide uniquement dans Internet Explorer 5 et versions ultérieures.

INTERNET_OPTION_OFFLINE_MODE

26

Non implémenté.

INTERNET_OPTION_OFFLINE_SEMANTICS

52

Non implémenté.

INTERNET_OPTION_OPT_IN_WEAK_SIGNATURE

176

Opt-in pour les signatures faibles (par exemple, SHA-1) à traiter comme non sécurisées. Cela indique à WinInet d’appeler CertGetCertificateChain à l’aide du paramètre CERT_CHAIN_OPT_IN_WEAK_SIGNATURE .

INTERNET_OPTION_PARENT_HANDLE

21

Récupère le handle parent de ce handle. Cette option peut être utilisée sur n’importe quel handle HINTERNET par InternetQueryOption.

INTERNET_OPTION_PASSWORD

29

Définit ou récupère une valeur de chaîne qui contient le mot de passe associé à un handle retourné par InternetConnect. Il est utilisé par InternetQueryOption et InternetSetOption.

INTERNET_OPTION_PER_CONNECTION_OPTION

75

Définit ou récupère une structure INTERNET_PER_CONN_OPTION_LIST qui spécifie une liste d’options pour une connexion particulière. Il est utilisé par InternetQueryOption et InternetSetOption. Cette option est valide uniquement dans Internet Explorer 5 et versions ultérieures.

Notes

INTERNET_OPTION_PER_CONNECTION_OPTION entraîne la modification des paramètres à l’échelle du système lorsqu’un handle NULL est utilisé dans l’appel à InternetSetOption. Pour actualiser les paramètres du proxy global, vous devez appeler InternetSetOption avec l’indicateur d’option INTERNET_OPTION_REFRESH .

Notes

Pour modifier les informations de proxy pour l’ensemble du processus sans affecter les paramètres globaux dans Internet Explorer 5 et versions ultérieures, utilisez cette option sur le handle retourné à partir d’InternetOpen. L’exemple de code suivant modifie le proxy pour l’ensemble du processus, même si le handle HINTERNET est fermé et n’est utilisé par aucune demande.

INTERNET_OPTION_POLICY

48

Non implémenté.

INTERNET_OPTION_PROXY

38

Définit ou récupère une structure de INTERNET_PROXY_INFO qui contient les données proxy d’un handle InternetOpen existant lorsque le handle HINTERNET n’est pas NULL. Si le handle HINTERNET a la valeur NULL, la fonction définit ou interroge les données proxy globales. Cette option peut être utilisée sur le handle retourné par InternetOpen. Il est utilisé par InternetQueryOption et InternetSetOption.

Notes

Il est recommandé d’utiliser INTERNET_OPTION_PER_CONNECTION_OPTION plutôt que INTERNET_OPTION_PROXY.

INTERNET_OPTION_PROXY_PASSWORD

44

Définit ou récupère une valeur de chaîne qui contient le mot de passe utilisé pour accéder au proxy. Il est utilisé par InternetQueryOption et InternetSetOption. Cette option peut être définie sur le handle retourné par InternetConnect ou HttpOpenRequest.

INTERNET_OPTION_PROXY_SETTINGS_CHANGED

95

Alerte le WinInet actuel instance que les paramètres du proxy ont changé et qu’ils doivent les mettre à jour avec les nouveaux paramètres. Pour alerter toutes les instances WinInet disponibles, définissez le paramètre Bufferd’InternetSetOption sur NULL et BufferLength sur 0 lors de la transmission de cette option. Cette option peut être définie sur le handle retourné par InternetConnect ou HttpOpenRequest.

INTERNET_OPTION_PROXY_USERNAME

43

Définit ou récupère une valeur de chaîne qui contient le nom d’utilisateur utilisé pour accéder au proxy. Il est utilisé par InternetQueryOption et InternetSetOption. Cette option peut être définie sur le handle retourné par InternetConnect ou HttpOpenRequest.

INTERNET_OPTION_READ_BUFFER_SIZE

12

Définit ou récupère une valeur entière longue non signée qui contient la taille de la mémoire tampon de lecture. Cette option peut être utilisée sur les handles HINTERNET retournés par FtpOpenFile, FtpFindFirstFile et InternetConnect (session FTP uniquement). Cette option est utilisée par InternetQueryOption et InternetSetOption.

INTERNET_OPTION_RECEIVE_THROUGHPUT

57

Non implémenté.

INTERNET_OPTION_RECEIVE_TIMEOUT

6

Définit ou récupère une valeur entière longue non signée qui contient la valeur de délai d’attente, en millisecondes, pour recevoir une réponse à une demande. Si la réponse prend plus de temps que cette valeur de délai d’attente, la demande est annulée. Cette option peut être utilisée sur n’importe quel handle HINTERNET , y compris un handle NULL . Il est utilisé par InternetQueryOption et InternetSetOption.

Cette option n’est pas destinée à représenter un délai d’attente précis et immédiat. Vous pouvez vous attendre à ce que le délai d’expiration se produise jusqu’à six secondes après la valeur de délai d’expiration définie.

Lorsqu’elle est utilisée en référence à une transaction FTP, cette option fait référence au canal de contrôle.

INTERNET_OPTION_REFRESH

37

Provoque la relecture des données proxy à partir du Registre pour un handle. Aucune mémoire tampon n’est requise. Cette option peut être utilisée sur le handle HINTERNET retourné par InternetOpen. Il est utilisé par InternetSetOption.

INTERNET_OPTION_REMOVE_IDENTITY

79

Non implémenté.

INTERNET_OPTION_REQUEST_FLAGS

23

Récupère une valeur entière longue non signée qui contient les indicateurs de status spéciaux qui indiquent la status du téléchargement en cours. Elle est utilisée par InternetQueryOption. L’option INTERNET_OPTION_REQUEST_FLAGS peut être l’une des valeurs suivantes :

INTERNET_REQFLAG_ASYNC

0x00000002

Non implémenté.

INTERNET_REQFLAG_CACHE_WRITE_DISABLED

0x00000040

La requête Internet ne peut pas être mise en cache (une requête HTTPS, par exemple).

INTERNET_REQFLAG_FROM_CACHE

0x00000001

La réponse est venue du cache.

INTERNET_REQFLAG_NET_TIMEOUT

0x00000080

La requête Internet a expiré.

INTERNET_REQFLAG_NO_HEADERS

0x00000008

La réponse d’origine ne contenait aucun en-tête.

INTERNET_REQFLAG_PASSIVE

0x00000010

Non implémenté.

INTERNET_REQFLAG_VIA_PROXY

0x00000004

La demande a été effectuée via un proxy.

INTERNET_OPTION_REQUEST_PRIORITY

58

Définit ou récupère une valeur entière longue non signée qui contient la priorité des requêtes qui entrent en concurrence pour une connexion sur un handle HTTP. Elle est utilisée par InternetQueryOption et InternetSetOption.

INTERNET_OPTION_RESET_URLCACHE_SESSION

60

Démarre une nouvelle session de cache pour le processus. Aucune mémoire tampon n’est requise. Elle est utilisée par InternetSetOption. Cette option est réservée à un usage interne uniquement.

INTERNET_OPTION_SECONDARY_CACHE_KEY

53

Définit ou récupère une valeur de chaîne qui contient la clé de cache secondaire. Elle est utilisée par InternetQueryOption et InternetSetOption. Cette option est réservée à un usage interne uniquement.

INTERNET_OPTION_SECURITY_CERTIFICATE

35

Récupère le certificat d’un serveur SSL/PCT (Secure Sockets Layer/Private Communications Technology) dans une chaîne mise en forme. Elle est utilisée par InternetQueryOption.

INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT

32

Récupère le certificat d’un serveur SSL/PCT dans la structure INTERNET_CERTIFICATE_INFO. Elle est utilisée par InternetQueryOption.

INTERNET_OPTION_SECURITY_FLAGS

31

Récupère une valeur entière longue non signée qui contient les indicateurs de sécurité d’un handle. Cette option est utilisée par InternetQueryOption. Il peut s’agir d’une combinaison des valeurs suivantes.

SECURITY_FLAG_128BIT

0x20000000

Identique à la valeur préférée SECURITY_FLAG_STRENGTH_STRONG. Cette valeur est uniquement retournée lors d’un appel à InternetQueryOption.

SECURITY_FLAG_40BIT

0x10000000

Identique à la valeur préférée SECURITY_FLAG_STRENGTH_WEAK. Cette valeur est uniquement retournée lors d’un appel à InternetQueryOption.

SECURITY_FLAG_56BIT

0x40000000

Identique à la valeur préférée SECURITY_FLAG_STRENGTH_MEDIUM. Cette valeur est uniquement retournée lors d’un appel à InternetQueryOption.

SECURITY_FLAG_FORTEZZA

0x08000000

Indique que Fortezza a été utilisé pour fournir le secret, l’authentification et/ou l’intégrité de la connexion spécifiée.

SECURITY_FLAG_IETFSSL4

0x00000020

Non implémenté.

SECURITY_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

Ignore le message d’erreur ERROR_INTERNET_SEC_CERT_CN_INVALID .

SECURITY_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

Ignore le message d’erreur ERROR_INTERNET_SEC_CERT_DATE_INVALID .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

Ignore le message d’erreur ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

Ignore le message d’erreur ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR .

SECURITY_FLAG_IGNORE_REVOCATION

0x00000080

Ignore les problèmes de révocation de certificats.

SECURITY_FLAG_IGNORE_UNKNOWN_CA

0x00000100

Ignore les problèmes d’autorité de certification inconnus.

SECURITY_FLAG_IGNORE_WEAK_SIGNATURE

0x00010000

Ignore les problèmes de signature de certificat faibles.

SECURITY_FLAG_IGNORE_WRONG_USAGE

0x00000200

Ignore les problèmes d’utilisation incorrects.

SECURITY_FLAG_NORMALBITNESS

0x10000000

Identique à la valeur SECURITY_FLAG_STRENGTH_WEAK. Cette valeur est uniquement retournée lors d’un appel à InternetQueryOption.

SECURITY_FLAG_PCT

0x00000008

Non implémenté.

SECURITY_FLAG_PCT4

0x00000010

Non implémenté.

SECURITY_FLAG_SECURE

0x00000001

Utilise des transferts sécurisés. Cette valeur est uniquement retournée lors d’un appel à InternetQueryOption.

SECURITY_FLAG_SSL

0x00000002

Non implémenté.

SECURITY_FLAG_SSL3

0x00000004

Non implémenté.

SECURITY_FLAG_STRENGTH_MEDIUM

0x40000000

Utilise un chiffrement moyen (56 bits). Cette valeur est uniquement retournée lors d’un appel à InternetQueryOption.

SECURITY_FLAG_STRENGTH_STRONG

0x20000000

Utilise un chiffrement fort (128 bits). Cette valeur est uniquement retournée lors d’un appel à InternetQueryOption.

SECURITY_FLAG_STRENGTH_WEAK

0x10000000

Utilise un chiffrement faible (40 bits). Cette valeur est uniquement retournée lors d’un appel à InternetQueryOption.

SECURITY_FLAG_UNKNOWNBIT

0x80000000

La taille de bits utilisée dans le chiffrement est inconnue. Cette valeur est uniquement retournée lors d’un appel à InternetQueryOption.

N’oubliez pas que les données récupérées de cette façon se rapportent à une transaction qui s’est produite et dont le niveau de sécurité ne peut plus être modifié.

INTERNET_OPTION_SECURITY_KEY_BITNESS

36

Récupère une valeur entière longue non signée qui contient la taille de bits de la clé de chiffrement. Plus le nombre est élevé, plus la force de chiffrement utilisée est élevée. Elle est utilisée par InternetQueryOption. N’oubliez pas que les données récupérées de cette façon concernent une transaction qui s’est déjà produite et dont le niveau de sécurité ne peut plus être modifié.

INTERNET_OPTION_SEND_THROUGHPUT

56

Non implémenté.

INTERNET_OPTION_SEND_TIMEOUT

5

Définit ou récupère une valeur entière longue non signée, en millisecondes, qui contient la valeur de délai d’attente pour envoyer une requête. Si l’envoi prend plus de temps que cette valeur de délai d’attente, l’envoi est annulé. Cette option peut être utilisée sur n’importe quel handle HINTERNET , y compris un handle NULL . Il est utilisé par InternetQueryOption et InternetSetOption.

Lorsqu’elle est utilisée en référence à une transaction FTP, cette option fait référence au canal de contrôle.

INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT

105

Récupère le contexte de chaîne de certificats du serveur en tant que PCCERT_CHAIN_CONTEXT dupliqué. Vous pouvez passer ce contexte dupliqué à n’importe quelle fonction d’API Crypto qui prend une PCCERT_CHAIN_CONTEXT. Vous devez appeler CertFreeCertificateChain sur le PCCERT_CHAIN_CONTEXT retourné lorsque vous avez terminé avec le contexte de chaîne de certificats.

Version: Nécessite Internet Explorer 8.0.

INTERNET_OPTION_SETTINGS_CHANGED

39

Avertit le système que les paramètres du Registre ont été modifiés afin qu’il vérifie les paramètres lors de l’appel suivant à InternetConnect. Elle est utilisée par InternetSetOption.

INTERNET_OPTION_SUPPRESS_SERVER_AUTH

104

Définit un objet de requête HTTP de telle sorte qu’il ne se connecte pas aux serveurs d’origine, mais effectue une ouverture de session automatique aux serveurs proxy HTTP. Cette option diffère de l’indicateur de requête INTERNET_FLAG_NO_AUTH, qui empêche l’authentification aux serveurs proxy et aux serveurs d’origine.

La définition de ce mode supprime l’utilisation de tout matériel d’informations d’identification (nom d’utilisateur/mot de passe ou certificat SSL client fourni précédemment) lors de la communication avec un serveur d’origine. Toutefois, si la demande doit transiter via un proxy d’authentification, WinINet effectue toujours l’authentification automatique auprès du proxy HTTP en fonction des paramètres de zone Intranet de l’utilisateur. Le paramètre de zone Intranet par défaut permet l’ouverture de session automatique à l’aide des informations d’identification par défaut de l’utilisateur.

Pour garantir la suppression de toutes les informations d’identification, l’appelant doit combiner INTERNET_OPTION_SUPPRESS_SERVER_AUTH avec l’indicateur de demande INTERNET_FLAG_NO_COOKIES .

Cette option ne peut être définie que sur les objets de demande avant leur envoi. Les tentatives de définition de cette option une fois la demande envoyée retournent ERROR_INTERNET_INCORRECT_HANDLE_STATE.

Aucune mémoire tampon n’est requise pour cette option. Elle est utilisée par InternetSetOption sur les descripteurs retournés par HttpOpenRequest uniquement.

Version: Nécessite Internet Explorer 8.0 ou version ultérieure.

INTERNET_OPTION_SUPPRESS_BEHAVIOR

81

Option à usage général utilisée pour supprimer les comportements à l’échelle du processus. Le paramètre lpBuffer de la fonction doit être un pointeur vers un DWORD contenant le comportement spécifique à supprimer. Cette option ne peut pas être interrogée avec InternetQueryOption. Les valeurs autorisées sont les suivantes :

INTERNET_SUPPRESS_RESET_ALL

0

Désactive toutes les suppressions, réactive le comportement par défaut et configuré. Cette option équivaut à définir INTERNET_SUPPRESS_COOKIE_POLICY_RESET et INTERNET_SUPPRESS_COOKIE_PERSIST_RESET individuellement.

Version: Nécessite Internet Explorer 6.0 ou version ultérieure.

INTERNET_SUPPRESS_COOKIE_POLICY

1

Ignore toutes les stratégies de cookies configurées et autorise la définition de cookies.

Version: Nécessite Internet Explorer 6.0 ou version ultérieure.

INTERNET_SUPPRESS_COOKIE_POLICY_RESET

2

Désactive la suppression INTERNET_SUPPRESS_COOKIE_POLICY , ce qui permet l’évaluation des cookies en fonction de la stratégie de cookie configurée.

Version: Nécessite Internet Explorer 6.0 ou version ultérieure.

INTERNET_SUPPRESS_COOKIE_PERSIST

3

Supprime la persistance des cookies, même si le serveur les a spécifiés comme persistants.

Version: Nécessite Internet Explorer 8.0 ou version ultérieure.

INTERNET_SUPPRESS_COOKIE_PERSIST_RESET

4

Désactive la suppression INTERNET_SUPPRESS_COOKIE_PERSIST et réactive la persistance des cookies. Les cookies précédemment supprimés ne deviennent pas persistants.

Version: Nécessite Internet Explorer 8.0 ou version ultérieure.

INTERNET_OPTION_URL

34

Récupère une valeur de chaîne qui contient l’URL complète d’une ressource téléchargée. Si l’URL d’origine contenait des données supplémentaires, telles que des chaînes de recherche ou des ancres, ou si l’appel a été redirigé, l’URL retournée diffère de l’url d’origine. Cette option est valide sur les handles HINTERNET retournés par InternetOpenUrl, FtpOpenFile, GopherOpenFile ou HttpOpenRequest. Il est utilisé par InternetQueryOption.

INTERNET_OPTION_USER_AGENT

41

Définit ou récupère la chaîne de l’agent utilisateur sur les handles fournis par InternetOpen et utilisés dans les fonctions HttpSendRequest suivantes, tant qu’elle n’est pas remplacée par un en-tête ajouté par HttpAddRequestHeaders ou HttpSendRequest. Il est utilisé par InternetQueryOption et InternetSetOption.

INTERNET_OPTION_USERNAME

28

Définit ou récupère une chaîne qui contient le nom d’utilisateur associé à un handle retourné par InternetConnect. Il est utilisé par InternetQueryOption et InternetSetOption.

INTERNET_OPTION_VERSION

40

Récupère une structure de INTERNET_VERSION_INFO qui contient le numéro de version de Wininet.dll. Cette option peut être utilisée sur un handle HINTERNETNULL par InternetQueryOption.

INTERNET_OPTION_WRITE_BUFFER_SIZE

13

Définit ou récupère une valeur entière longue non signée qui contient la taille, en octets, de la mémoire tampon d’écriture. Cette option peut être utilisée sur les handles HINTERNET retournés par FtpOpenFile et InternetConnect (session FTP uniquement). Il est utilisé par InternetQueryOption et InternetSetOption.

Notes

Notes

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

Spécifications

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; Winineti.h