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 sont inférieures ou égales à Internet _ Last _ option.

_option Internet _ ALTER _ Identity

80

Non implémenté

_option Internet _ Async

30

Non implémenté.

_ _ ID Async de l’option Internet _

15

Non implémenté.

_option Internet _ _ priorité asynchrone

16

Non implémenté.

_option Internet _ Ignorer _ l' _ entrée modifiée

64

Définit ou récupère la valeur booléenne qui détermine si le système doit vérifier si le réseau dispose d’un contenu plus récent et remplacer les entrées du cache modifiées si une version plus récente est trouvée. Si la valeur est true, le système vérifie que le contenu du réseau est plus récent et remplace l’entrée de cache modifiée par la version 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érification du réseau. Utilisé par InternetQueryOption et InternetSetOption. Elle est valide uniquement dans Microsoft Internet Explorer 5 et versions ultérieures.

_ _ _ descripteur du flux de cache des options Internet _

27

N'est plus pris en charge.

_ _ horodateurs du cache des options Internet _

69

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

_rappel d’option Internet _

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 descripteurs HINTERNET . Utilisé par InternetQueryOption et InternetSetOption.

_filtre de _ rappel d’option Internet _

54

Non implémenté.

_contexte de _ _ certificat client _ de l’option Internet

84

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

page de codes de l' _ option Internet _

68

Par défaut, la partie hôte ou autorité de l’URL Unicode est encodée en fonction de la spécification IDN. Si vous définissez cette option sur la demande, ou sur le descripteur de connexion, lorsque l’IDN est désactivé, 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 l’IDN n’est pas désactivé. Pour plus d’informations sur la désactivation de l’IDN, consultez l’option Internet _ _ 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.

chemin de la page de codes de l' _ option Internet _ _

100

Par défaut, la partie chemin d’accès de l’URL est encodée en UTF8. L’API WinINet effectue un encodage de caractère d’échappement (%) sur les caractères étendus. La définition de cette option sur la demande, ou le descripteur 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 codes DBCS souhaitée pour le chemin d’accès. Si aucune page de codes n’est spécifiée dans lpBuffer, Wininet utilise la valeur par défaut de CP _ UTF8.

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.

page de codes de l' _ option Internet _ _ 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 de caractère d’échappement (%) ne sont pas effectuées sur la partie supplémentaire. La définition de cette option sur la demande ou sur le descripteur de connexion désactive le _ codage ACP 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.

_longueur du _ _ contenu compressé des options _ Internet

147

Pour une demande dans laquelle WinInet décompresse l’encodage de contenu fourni par le serveur, récupère la longueur de contenu signalée par le serveur du corps de la réponse en tant que ULONGLONG. pris en charge dans Windows 10, version 1507 et versions ultérieures.

_option Internet _ connexion-interruption _

4

Non implémenté.

_ _ nouvelles tentatives de connexion des options Internet _

3

Définit ou récupère une valeur d’entier long non signé qui contient le nombre de fois que WinINet tente de résoudre et de se connecter à un hôte. Elle tente une seule fois par adresse IP. Par exemple, si vous tentez de vous connecter à un hôte à hébergement multiple qui possède dix adresses IP et que _ les nouvelles tentatives de connexion d’option Internet ont _ _ la valeur 7, Wininet tente uniquement de résoudre les sept premières adresses IP et de s’y connecter. À l’inverse, étant donné le même ensemble de dix adresses IP, si l' _ option Internet _ Connect _ tentativess est définie sur 20, Wininet tente chacune des dix une seule fois. Si un ordinateur 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 encore après le nombre de tentatives spécifié, la demande est annulée. La valeur par défaut pour _ les _ nouvelles tentatives de connexion des options Internet est de _ cinq tentatives. Cette option peut être utilisée sur n’importe quel handle HINTERNET , y compris un handle null . Elle est utilisée par InternetQueryOption et InternetSetOption.

heure de connexion de l' _ option Internet _ _

55

Non implémenté.

_ _ délai d’attente de connexion des options Internet _

2

Définit ou récupère une valeur d’entier long non signé qui contient la valeur du délai d’attente, en millisecondes, à utiliser pour les demandes de connexion Internet. La définition de cette option sur Infinite (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 seul hôte (un hôte multirésident), le délai d’expiration est cumulatif pour toutes les adresses IP. Cette option peut être utilisée sur n’importe quel handle HINTERNET , y compris un handle null . Elle est utilisée par InternetQueryOption et InternetSetOption.

_ _ état connecté de l’option Internet _

50

Définit ou récupère une valeur d’entier long non signé qui contient l’état connecté. Utilisé par InternetQueryOption et InternetSetOption.

valeur de contexte de l' _ option Internet _ _

45

Définit ou récupère un PTR DWORD _ 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 . Utilisé par InternetQueryOption et InternetSetOption. Précédemment, cette valeur définit 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 que l’indicateur de _ valeur de _ contexte _ d’option Internet se voit attribuer une nouvelle valeur. L’ancienne valeur, 10, a été conservée afin que les applications écrites pour l’ancien comportement soient toujours prises en charge.

_délai de _ _ réception du contrôle _ d’option Internet

6

Identique au _ _ _ délai d’attente de réception des options Internet. Utilisé par InternetQueryOption et InternetSetOption.

_ _ _ _ délai d’attente d’envoi du contrôle d’option Internet

5

Identique au _ _ _ délai d’attente d’envoi des options Internet. Utilisé par InternetQueryOption et InternetSetOption.

_délai de _ réception des données des options Internet _ _

8

Définit ou récupère une valeur d’entier long non signé qui contient la valeur du 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 . Elle est utilisée par InternetQueryOption et InternetSetOption.

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

_ _ _ délai d’envoi des données des options Internet _

7

Définit ou récupère une valeur d’entier long non signé, en millisecondes, qui contient la valeur du délai d’attente pour envoyer une demande 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 . Elle est utilisée par InternetQueryOption et InternetSetOption.

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

_nom du _ fichier de fichier de l’option Internet _

33

Récupère une valeur de chaîne qui contient le nom du fichier qui stocke une entité téléchargée. Cet indicateur est valide après la fin de InternetOpenUrl, FtpOpenFile, GopherOpenFileou HttpOpenRequest . Cette option ne peut être interrogée que par InternetQueryOption.

_extension du _ fichier de fichier de l’option Internet _

96

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

_ _ _ informations sur le socket de diagnostic des options Internet _

67

Récupère une structure d' _ _ _ informations de socket de diagnostic Internet qui contient les données relatives à une requête http spécifiée. Cet indicateur est utilisé par InternetQueryOption.

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

_option Internet _ Digest _ auth _ Unload

76

Fait en sorte que le système se déconnecte du package SSPI d’authentification Digest, en vidant toutes les informations d’identification créées pour le processus. Aucune mémoire tampon n’est requise pour cette option. Elle est utilisée par InternetSetOption.

_option Internet _ désactiver la _ numérotation automatique

70

Non implémenté.

_délai d’attente de l’option Internet _ déconnectée _

49

Non implémenté.

_option Internet _ activer _ le _ protocole http

148

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

  • _ _ Indicateur de protocole http _ http2 (0X2). pris en charge sur Windows 10, la version 1507 et les versions ultérieures.

Les versions héritées de HTTP (1,1 et versions 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 versions ultérieures.

_option Internet _ activer _ la _ lecture du cache de redirection _

122

Sur un handle de demande, définit un booléen qui contrôle si les redirections sont 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.

_option Internet _ coder _ extra

155

Obtient/définit une valeur BOOLÉENNE 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.

_option Internet _ fin _ de _ session du navigateur

42

Vide les entrées qui ne sont pas utilisées à partir du cache de mot de passe sur le disque dur. Réinitialise également le temps de cache utilisé lorsque le mode de synchronisation est une fois par session. Aucune mémoire tampon n’est requise pour cette option. Utilisé par InternetSetOption.

_masque d' _ erreur des options Internet _

62

Définit une valeur d’entier long non signé 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 :

_ _ _ _ certificat sec combiné au masque d’erreurs Internet _

0x2

Indique que toutes les erreurs de certificat doivent être signalées à l’aide du même retour d’erreur, à savoir les _ Erreurs de certificat Error Internet _ s _ _. Si cet indicateur est défini, appelez InternetErrorDlg lors de la réception de l’erreur erreur _ Internet _ s _ 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 d’usurpation d’identité potentielles.

masque d’erreur INTERNET- _ _ Insérer un CD- _ _ ROM

0x1

Indique que l’application cliente peut gérer le code d’erreur d’insertion dans le _ _ _ cdrom Internet .

échec de connexion au masque d’erreur INTERNET afficher le corps de l' _ _ _ _ _ _ entité _

0x8

Indique que l’application cliente peut gérer l' erreur Échec de la connexion Internet afficher le code d’erreur _ _ _ _ _ _ du corps de l’entité.

le _ masque d’erreurs Internet a _ besoin de _ _ MSN _ SSPI _ pkg

0x4

Non implémenté.

_contexte d' _ entreprise _ option Internet

159

définit un PWSTR contenant l’ID de Enterprise (consultez 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 versions ultérieures.

_ _ erreur étendue de l’option Internet _

24

Récupère une valeur d’entier long non signé qui contient un code d’erreur Winsock mappé à l’erreur messages d’erreur _ Internet _ retournés dans ce contexte de thread. Cette option est utilisée sur un handle HINTERNET null par InternetQueryOption.

_option Internet _ du _ délai d’expiration du cache _

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 demande réseau avant de vérifier le cache pour une copie de la ressource. Si une requête réseau prend plus de temps que l’heure spécifiée et que la ressource demandée est disponible dans le cache, la ressource est récupérée à partir du cache. Utilisé par InternetQueryOption et InternetSetOption.

TYPE de handle de l' _ option Internet _ _

9

Récupère une valeur d’entier long non signé qui contient le type des handles HINTERNET passés. Utilisé par InternetQueryOption sur n’importe quel handle HINTERNET . Les valeurs de retour possibles sont les suivantes.

_type de descripteur Internet _ _ connecter _ FTP

2

_type de descripteur Internet _ _ connecter _ Gopher

3

_type de descripteur Internet _ _ Connect _ http

4

_demande de _ fichier de type de handle Internet _ _

14

_ _ fichier FTP de type descripteur Internet _ _

7

_type de descripteur Internet _ _ _ fichier FTP _ HTML

8

_ _ recherche FTP du type de descripteur Internet _ _

5

_type de descripteur Internet _ _ FTP _ Rechercher _ HTML

6

_type de descripteur Internet- _ _ _ fichier Gopher

11

_type de descripteur Internet du _ _ _ fichier Gopher _ HTML

12

_ _ recherche Gopher du type de descripteur Internet _ _

9

_type de descripteur Internet _ _ Gopher _ Rechercher _ HTML

10

_ _ requête HTTP de type descripteur Internet _ _

13

_type de descripteur Internet _ _ Internet

1

_option Internet _ HSTS

157

Obtient/définit une valeur BOOLÉENNE qui indique si WinInet doit suivre les directives HSTS (HTTP strict transport Security) des serveurs. Si cette option est activée, les demandes de https://mises en cache pour les domaines qui ont une stratégie HSTS mise en cache par WinInet sont redirigées vers les URL https://correspondantes. La valeur par défaut est FALSE. pris en charge dans Windows 8.1 et versions ultérieures.

_décodage http des options Internet _ _

65

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

_option Internet _ _ protocole http _ utilisée

149

Obtient une valeur DWORD qui indique quelle version HTTP avancée a été utilisée sur une demande donnée. Les valeurs possibles sont les suivantes :

  • _ _ Indicateur de protocole http _ http2 (0X2). pris en charge sur Windows 10, la version 1507 et les versions ultérieures.

0x0 indique HTTP/1.1 ou une version antérieure ; consultez _ la version http de l’option Internet _ si une _ plus grande précision est nécessaire pour déterminer quelle version héritée a été utilisée. pris en charge sur Windows 10, la version 1507 et les versions ultérieures.

_ _ version http de l’option Internet _

59

Définit ou récupère une structure d' _ _ informations de version http qui contient la version http prise en charge. Elle doit être utilisée sur un handle null . Utilisé par InternetQueryOption et InternetSetOption.

sur Windows 7, Windows Server 2008 R2 et versions ultérieures, la valeur du membre dwMinorVersion dans la structure INFO de la _ VERSION _ HTTP est remplacée par les paramètres d’Internet Explorer. EnableHttp1 _ 1 est une valeur de Registre sous HKLM \ Software \ Microsoft \ InternetExplorer \ AdvacnedOptions \ http \ GENABLE contrôlé par les options Internet définies dans Internet Explorer pour le système. La valeur EnableHttp1 _ 1 est définie par défaut sur 1. La structure des _ _ informations de version http est ignorée pour toute VERSION http inférieure à 1,1 si EnableHttp1 _ 1 est défini sur 1.

identité de l' _ option Internet _

78

Non implémenté.

_ _ état inactif des options Internet _

51

Non implémenté.

_IDN des options Internet _

102

Par défaut, la partie hôte ou autorité de l’URL est encodée en fonction de la spécification IDN pour les connexions directes et par proxy. Cette option peut être utilisée sur la demande ou sur le descripteur de connexion pour activer ou désactiver les IDN. Lorsque l’IDN est désactivé, WinINet utilise la page de codes du 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 d’IDN uniquement sur la connexion directe, spécifiez les _ indicateurs Internet _ IDN _ directs dans le paramètre lpBuffer de l’appel à InternetSetOption. Pour activer la conversion IDN uniquement sur la connexion proxy, spécifiez le _ proxy d’indicateur Internet _ _ IDN dans le paramètre lpBuffer de 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.

_option Internet _ Ignorer _ hors connexion

77

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

_option Internet _ conserver la _ connexion

22

Non implémenté.

_ _ _ délai d’attente d’écoute des options Internet

11

Non implémenté.

_Option Internet _ Max _ Conns _ par _ _ serveur 1 0 _

74

Définit ou récupère une valeur d’entier long non signé qui contient le nombre maximal de connexions autorisées par serveur HTTP/1.0. Utilisé par InternetQueryOption et InternetSetOption. Cette option n’est valide que dans Internet Explorer 5 et versions ultérieures.

_option Internet _ Max _ Conns _ par _ proxy

103

Définit ou récupère une valeur d’entier long non signé qui contient le nombre maximal de connexions autorisées par proxy CERN. Lorsque cette option est définie ou récupérée, le paramètre hInternet doit être défini 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 actuel. Lors de l’appel de InternetSetOption avec cette option, tous les objets proxy existants recevront la nouvelle valeur. Cette valeur est limitée à une plage comprise entre 2 et 128 inclus.

Version: Nécessite Internet Explorer 8,0.

_option Internet _ Max _ Conns _ par _ serveur

73

Définit ou récupère une valeur d’entier long non signé qui contient le nombre maximal de connexions autorisées par serveur. Utilisé par InternetQueryOption et InternetSetOption. Cette option n’est valide que dans Internet Explorer 5 et versions ultérieures.

_option Internet _ _ en mode hors connexion

26

Non implémenté.

_ _ sémantiques hors connexion des options Internet _

52

Non implémenté.

_option Internet _ OPT _ dans _ une _ signature faible

176

Abonnez-vous à des signatures faibles (par exemple, SHA-1) pour qu’elles soient considérées comme non sécurisées. Cela indique à WinInet d’appeler CertGetCertificateChain à l’aide de la _ chaîne _ de certificats opt dans le paramètre _ de _ _ signature faible .

_ _ handle parent de l’option Internet _

21

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

_ _ mot de passe de l’option Internet

29

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

option _ Internet _ par _ option de connexion _

75

Définit ou récupère une structure de liste d’options Internet _ par _ conn _ _ qui spécifie une liste d’options pour une connexion particulière. Utilisé par InternetQueryOption et InternetSetOption. Cette option n’est valide que dans Internet Explorer 5 et versions ultérieures.

Notes

Internet _ Option _ per _ Connection _ entraîne la modification des paramètres à l’échelle du système lorsqu’un descripteur null est utilisé dans l’appel à InternetSetOption. Pour actualiser les paramètres de proxy globaux, vous devez appeler InternetSetOption avec l’indicateur option d’actualisation de l' _ option _ Internet .

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 descripteur renvoyé par 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.

_stratégie d’option Internet _

48

Non implémenté.

_proxy d’option Internet _

38

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

Notes

Il est recommandé _ d’utiliser l’option option Internet _ par _ connexion à la place de l’option _ Internet _ _ proxy.

_ _ mot de passe du proxy de l’option Internet _

44

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

paramètres de proxy de l' _ option Internet _ _ _ modifiés

95

Alerte l’instance WinInet actuelle que les paramètres de proxy ont changé et qu’ils doivent mettre à jour avec les nouveaux paramètres. Pour alerter toutes les instances WinInet disponibles, définissez le paramètre buffer de InternetSetOption sur null et BufferLength sur 0 lors du passage de cette option. Cette option peut être définie sur le descripteur renvoyé par internetconnect ou HttpOpenRequest.

_ _ _ nom d’utilisateur du proxy de l’option Internet

43

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

_taille de _ la _ mémoire tampon de lecture des options Internet _

12

Définit ou récupère une valeur d’entier long non signé 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, FtpFindFirstFileet internetconnect (session FTP uniquement). Cette option est utilisée par InternetQueryOption et InternetSetOption.

_débit de _ réception des options Internet _

57

Non implémenté.

_délai de _ réception des options Internet _

6

Définit ou récupère une valeur d’entier long non signé qui contient la valeur du 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 . Elle est utilisée par InternetQueryOption et InternetSetOption.

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

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

_actualisation des options Internet _

37

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

_option Internet _ Supprimer l' _ identité

79

Non implémenté.

_indicateurs de _ demande d’option Internet _

23

Récupère une valeur d’entier long non signé qui contient les indicateurs d’État spéciaux qui indiquent l’état du téléchargement en cours. Utilisé par InternetQueryOption. L’option d' _ indicateurs de _ demande _ d’option Internet peut prendre l’une des valeurs suivantes :

INTERNET _ REQFLAG _ Async

0x00000002

Non implémenté.

_ _ écriture du cache Internet REQFLAG _ _ désactivée

0x00000040

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

INTERNET _ REQFLAG _ à partir du _ cache

0x00000001

La réponse provient du cache.

_ _ _ délai d’expiration réseau Internet REQFLAG

0x00000080

Délai d’attente de la demande Internet dépassé.

INTERNET _ REQFLAG _ aucun _ en-tête

0x00000008

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

INTERNET _ REQFLAG _ passif

0x00000010

Non implémenté.

INTERNET _ REQFLAG _ via le _ proxy

0x00000004

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

priorité de la _ demande d’option Internet _ _

58

Définit ou récupère une valeur d’entier long non signé qui contient la priorité des demandes qui sont en concurrence pour une connexion sur un handle HTTP. Utilisé par InternetQueryOption et InternetSetOption.

_option Internet _ Réinitialiser _ la _ session URLCACHE

60

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

_clé de _ _ cache secondaire _ de l’option Internet

53

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

certificat de sécurité de l' _ option Internet _ _

35

Récupère le certificat pour un serveur de technologie de communications SSL/PCT (SSL (Secure Sockets Layer)/Private) dans une chaîne formatée. Utilisé par InternetQueryOption.

_structure de _ certificat de sécurité _ _ de l’option Internet

32

Récupère le certificat pour un serveur SSL/PCT dans la structure des _ informations de certificat Internet _ . Utilisé par InternetQueryOption.

indicateurs de sécurité de l' _ option Internet _ _

31

Récupère une valeur d’entier long non signé 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.

Indicateur de sécurité _ _ 128 bits

0x20000000

Identique à la valeur par défaut intensité de l' indicateur de sécurité _ _ _ forte. Cela est retourné uniquement dans un appel à InternetQueryOption.

Indicateur de sécurité _ _ 40BIT

0x10000000

Identique à la valeur préférée force de l’indicateur de sécurité _ _ _ faible. Cela est retourné uniquement dans un appel à InternetQueryOption.

Indicateur de sécurité _ _ 56BIT

0x40000000

Identique au niveau de performance de l’indicateur de sécurité de valeur par défaut. _ _ _ Cela est retourné uniquement dans un appel à InternetQueryOption.

indicateur de sécurité _ _ Fortezza

0x08000000

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

Indicateur de sécurité _ _ IETFSSL4

0x00000020

Non implémenté.

indicateur de sécurité ignorer le nom _ _ commun du _ certificat _ _ non valide

0x00001000

Ignore le message d’erreur erreur _ _ _ _ _ non valide du certificat d’Internet s .

indicateur de sécurité _ _ ignore la _ Date de certificat _ _ non valide

0x00002000

Ignore le message d’erreur erreur _ Internet _ s _ CERT _ date _ non valide .

_indicateur _ de sécurité ignorer _ la redirection _ vers _ http

0x00008000

Ignore l' erreur _ Internet _ https _ à _ http _ sur le message d’erreur de _ ReDim .

_indicateur _ de sécurité ignorer _ la redirection _ vers _ https

0x00004000

Ignore l' erreur _ Internet _ http _ à _ https _ sur le message d’erreur de _ ReDim .

indicateur de sécurité _ _ ignore la _ révocation

0x00000080

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

indicateur de sécurité _ _ ignorer l’autorité de _ _ certification inconnue

0x00000100

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

indicateur de sécurité _ _ ignorer la _ _ signature faible

0x00010000

Ignore les problèmes de signature de certificat faible.

indicateur de sécurité _ _ ignorant _ l’utilisation incorrecte _

0x00000200

Ignore les problèmes d’utilisation incorrects.

indicateur de sécurité _ _ NORMALBITNESS

0x10000000

Identique à la valeur _ _ _ faible forcede l’indicateur de sécurité. Cela est retourné uniquement dans un appel à InternetQueryOption.

indicateur de sécurité _ _ PCT

0x00000008

Non implémenté.

Indicateur de sécurité _ _ PCT4

0x00000010

Non implémenté.

indicateur de sécurité _ _ sécurisé

0x00000001

Utilise des transferts sécurisés. Cela est retourné uniquement dans un appel à InternetQueryOption.

indicateur de sécurité _ _ SSL

0x00000002

Non implémenté.

Indicateur de sécurité _ _ SSL3

0x00000004

Non implémenté.

niveau de force de l’indicateur de sécurité _ _ _

0x40000000

Utilise le chiffrement moyen (56 bits). Cela est retourné uniquement dans un appel à InternetQueryOption.

force de l’indicateur de sécurité _ _ _ Strong

0x20000000

Utilise le chiffrement fort (128 bits). Cela est retourné uniquement dans un appel à InternetQueryOption.

force de l’indicateur de sécurité _ _ _ faible

0x10000000

Utilise un chiffrement faible (40 bits). Cela est retourné uniquement dans un appel à InternetQueryOption.

indicateur de sécurité _ _ UNKNOWNBIT

0x80000000

La taille en bits utilisée dans le chiffrement est inconnue. Cela est retourné uniquement dans un appel à InternetQueryOption.

Sachez que les données récupérées de cette façon sont liées à une transaction qui s’est produite, dont le niveau de sécurité ne peut plus être modifié.

nombre de bits de la clé de sécurité de l' _ option Internet _ _ _

36

Récupère une valeur d’entier long non signé qui contient la taille en bits de la clé de chiffrement. Plus le nombre est élevé, plus la force de chiffrement utilisée est élevée. Utilisé par InternetQueryOption. Sachez que les données récupérées de cette façon sont liées à une transaction qui s’est déjà produite, dont le niveau de sécurité ne peut plus être modifié.

_débit d' _ envoi des options Internet _

56

Non implémenté.

_ _ _ délai d’attente d’envoi des options Internet

5

Définit ou récupère une valeur d’entier long non signé, en millisecondes, qui contient la valeur du délai d’attente pour envoyer une demande. 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 . Elle est utilisée 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.

_contexte de _ chaîne du certificat du serveur d’options Internet _ _ _

105

Récupère le contexte de la chaîne de certificats du serveur en tant que _ _ contexte de chaîne PCCERTen double. Vous pouvez passer ce contexte dupliqué à toute fonction API de chiffrement qui prend un _ _ contexte de chaîne PCCERT. Vous devez appeler CertFreeCertificateChain sur le contexte de _ chaîne _ PCCERT retourné lorsque vous avez terminé avec le contexte de la chaîne de certificats.

Version: Nécessite Internet Explorer 8,0.

_paramètres d’option Internet _ _ modifiés

39

Informe 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. Utilisé par InternetSetOption.

_option Internet _ supprimer _ l' _ authentification du serveur

104

Définit un objet de requête HTTP de sorte qu’il ne se connecte pas aux serveurs d’origine, mais effectue une ouverture de session automatique sur les 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.

En définissant ce mode, vous supprimez l’utilisation de tout document d’informations d’identification (nom d’utilisateur/mot de passe ou certificat SSL client précédemment fourni) 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 sur le proxy HTTP en fonction des paramètres de la zone Intranet de l’utilisateur. Le paramètre de zone Intranet par défaut permet d’autoriser 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 l' _ option Internet option _ Supprimer l' _ _ authentification du serveur avec l’indicateur de requête Internet _ indicateur _ aucun _ cookie .

Cette option ne peut être définie que sur des objets de requête avant d’être envoyés. Toute tentative de définition de cette option après l’envoi de la demande retourne l' État d’erreur du _ _ _ handle _ Internet incorrect.

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

Version: Nécessite Internet Explorer 8,0 ou une version ultérieure.

_comportement de _ suppression des options Internet _

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 une valeur DWORD contenant le comportement spécifique à supprimer. Cette option ne peut pas être interrogée avec InternetQueryOption. Les valeurs autorisées sont les suivantes :

_suppression Internet _ Réinitialiser _ tout

0

Désactive toutes les suppressions, réactivation des comportements par défaut et configurés. Cette option est équivalente à la configuration de la _ _ _ _ réinitialisation de la stratégie de cookies par Internet et à la _ _ _ _ réinitialisation permanente des cookies Internet .

Version: Nécessite Internet Explorer 6,0 ou une version ultérieure.

_stratégie de _ cookies supprimée par Internet _

1

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

Version: Nécessite Internet Explorer 6,0 ou une version ultérieure.

suppression d’INTERNET _ Supprimer la _ stratégie de cookie _ _

2

Désactive la suppression d' Internet _ supprimer _ la _ stratégie de cookie , en autorisant l’évaluation des cookies en fonction de la stratégie de cookie configurée.

Version: Nécessite Internet Explorer 6,0 ou une version ultérieure.

le _ cookie supprimé par Internet est _ _ conservé

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 une version ultérieure.

_ _ _ réinitialisation permanente des cookies supprimés d’Internet _

4

Désactive la suppression de la _ _ _ conservation de cookie Internet , réactivation de la persistance des cookies. Les cookies précédemment supprimés ne sont pas persistants.

Version: Nécessite Internet Explorer 8,0 ou une version ultérieure.

URL de l' _ option Internet _

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 ou des ancres de recherche, ou si l’appel a été redirigé, l’URL retournée est différente de l’original. Cette option est valide sur les handles HINTERNET retournés par InternetOpenUrl, FtpOpenFile, GopherOpenFileou HttpOpenRequest. Elle est utilisée par InternetQueryOption.

_option Internet _ _ agent utilisateur

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, à condition qu’elles ne soient pas remplacées par un en-tête ajouté par HttpAddRequestHeaders ou HTTPSendRequest. Utilisé par InternetQueryOption et InternetSetOption.

_ _ nom d’utilisateur de l’option Internet

28

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

VERSION de l' _ option Internet _

40

Récupère une structure d' _ _ informations de version Internet qui contient le numéro de version de Wininet.dll. Cette option peut être utilisée sur un handle HINTERNET null par InternetQueryOption.

_taille de _ la _ mémoire tampon d’écriture des options Internet _

13

Définit ou récupère une valeur d’entier long non signé 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). Elle est utilisée 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