Indicateurs d’API

De nombreuses fonctions WinINet acceptent un tableau d’indicateurs en tant que paramètre. Voici une brève description des indicateurs définis.

INTERNET_COOKIE_EVALUATE_P3P

0x80

Indique qu’un en-tête Platform for Privacy Protection (P3P) doit être associé à un cookie.

INTERNET_COOKIE_THIRD_PARTY

0x10

Indique qu’un cookie tiers est en cours de définition ou de récupération.

INTERNET_FLAG_ASYNC

0x10000000

Effectue uniquement les requêtes asynchrones sur les handles descendant du handle retourné par cette fonction. Seule la fonction InternetOpen utilise cet indicateur.

INTERNET_FLAG_CACHE_ASYNC

0x00000080

Autorise une écriture de cache différée.

INTERNET_FLAG_CACHE_IF_NET_FAIL

0x00010000

Retourne la ressource à partir du cache si la demande réseau de la ressource échoue en raison d’une erreur de ERROR_INTERNET_CONNECTION_RESET ou de ERROR_INTERNET_CANNOT_CONNECT . Cet indicateur est utilisé par HttpOpenRequest.

INTERNET_FLAG_DONT_CACHE

0x04000000

N’ajoute pas l’entité retournée au cache. Cette valeur est identique à la valeur préférée , INTERNET_FLAG_NO_CACHE_WRITE.

INTERNET_FLAG_EXISTING_CONNECT

0x20000000

Tente d’utiliser un objet InternetConnect existant s’il en existe un avec les mêmes attributs requis pour effectuer la demande. Cela est utile uniquement pour les opérations FTP, car FTP est le seul protocole qui effectue généralement plusieurs opérations au cours de la même session. WinINet met en cache un descripteur de connexion unique pour chaque handle HINTERNET généré par InternetOpen. Les fonctions InternetOpenUrl et InternetConnect utilisent cet indicateur pour les connexions Http et Ftp.

INTERNET_FLAG_FORMS_SUBMIT

0x00000040

Indique qu’il s’agit d’une soumission de formulaires.

INTERNET_FLAG_FROM_CACHE

0x01000000

N’effectue pas de demandes réseau. Toutes les entités sont retournées à partir du cache. Si l’élément demandé n’est pas dans le cache, une erreur appropriée, telle que ERROR_FILE_NOT_FOUND, est retournée. Seule la fonction InternetOpen utilise cet indicateur.

INTERNET_FLAG_FWD_BACK

0x00000020

Indique que la fonction doit utiliser la copie de la ressource qui se trouve actuellement dans le cache Internet. La date d’expiration et d’autres informations sur la ressource ne sont pas vérifiées. Si l’élément demandé est introuvable dans le cache Internet, le système tente de localiser la ressource sur le réseau. Cette valeur a été introduite dans Microsoft Internet Explorer 5 et est associée aux opérations de bouton Suivant et Précédent d’Internet Explorer.

INTERNET_FLAG_HYPERLINK

0x00000400

Force un rechargement s’il n’y a pas d’heure d’expiration et qu’aucune heure LastModified n’est retournée par le serveur lors de la détermination du rechargement de l’élément à partir du réseau. Cet indicateur peut être utilisé par FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest et InternetOpenUrl.

Windows XP et Windows Server 2003 R2 et versions antérieures : Également utilisé par GopherFindFirstFile et GopherOpenFile.

INTERNET_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

Désactive la vérification des certificats SSL/PCT retournés par le serveur par rapport au nom d’hôte indiqué dans la demande. WinINet utilise un case activée simple par rapport aux certificats en comparant les noms d’hôtes et les règles de caractères génériques simples. Cet indicateur peut être utilisé par HttpOpenRequest et InternetOpenUrl (pour les requêtes HTTP).

INTERNET_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

Désactive la vérification des certificats SSL/PCT pour les dates de validité appropriées. Cet indicateur peut être utilisé par HttpOpenRequest et InternetOpenUrl (pour les requêtes HTTP).

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

Désactive la détection de ce type spécial de redirection. Lorsque cet indicateur est utilisé, WinINet autorise en toute transparence les redirections de HTTPS vers les URL HTTP. Cet indicateur peut être utilisé par HttpOpenRequest et InternetOpenUrl (pour les requêtes HTTP).

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

Désactive la détection de ce type spécial de redirection. Lorsque cet indicateur est utilisé, WinINet autorise en toute transparence les redirections de HTTP vers les URL HTTPS. Cet indicateur peut être utilisé par HttpOpenRequest et InternetOpenUrl (pour les requêtes HTTP).

INTERNET_FLAG_KEEP_CONNECTION

0x00400000

Utilise la sémantique keep-alive, si disponible, pour la connexion. Cet indicateur est utilisé par HttpOpenRequest et InternetOpenUrl (pour les requêtes HTTP). Cet indicateur est requis pour Microsoft Network (MSN), NTLM et d’autres types d’authentification.

INTERNET_FLAG_MAKE_PERSISTENT

0x02000000

N'est plus pris en charge.

INTERNET_FLAG_MUST_CACHE_REQUEST

0x00000010

Identique à la valeur préférée, INTERNET_FLAG_NEED_FILE. Provoque la création d’un fichier temporaire si le fichier ne peut pas être mis en cache. Cet indicateur peut être utilisé par FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest et InternetOpenUrl.

Windows XP et Windows Server 2003 R2 et versions antérieures : Également utilisé par GopherFindFirstFile et GopherOpenFile.

INTERNET_FLAG_NEED_FILE

0x00000010

Provoque la création d’un fichier temporaire si le fichier ne peut pas être mis en cache. Cet indicateur peut être utilisé par FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest et InternetOpenUrl.

Windows XP et Windows Server 2003 R2 et versions antérieures : Également utilisé par GopherFindFirstFile et GopherOpenFile.

INTERNET_FLAG_NO_AUTH

0x00040000

Ne tente pas l’authentification automatiquement. Cet indicateur peut être utilisé par HttpOpenRequest et InternetOpenUrl (pour les requêtes HTTP).

INTERNET_FLAG_NO_AUTO_REDIRECT

0x00200000

Ne gère pas automatiquement la redirection dans HttpSendRequest. Cet indicateur peut également être utilisé par InternetOpenUrl pour les requêtes HTTP.

INTERNET_FLAG_NO_CACHE_WRITE

0x04000000

N’ajoute pas l’entité retournée au cache. Cet indicateur est utilisé par , HttpOpenRequest et InternetOpenUrl.

Windows XP et Windows Server 2003 R2 et versions antérieures : Également utilisé par GopherFindFirstFile et GopherOpenFile.

INTERNET_FLAG_NO_COOKIES

0x00080000

N’ajoute pas automatiquement d’en-têtes de cookie aux demandes et n’ajoute pas automatiquement les cookies retournés à la base de données de cookies. Cet indicateur peut être utilisé par HttpOpenRequest et InternetOpenUrl (pour les requêtes HTTP).

INTERNET_FLAG_NO_UI

0x00000200

Désactive la boîte de dialogue cookie. Cet indicateur peut être utilisé par HttpOpenRequest et InternetOpenUrl (requêtes HTTP uniquement).

INTERNET_FLAG_OFFLINE

0x01000000

Identique à INTERNET_FLAG_FROM_CACHE. N’effectue pas de demandes réseau. Toutes les entités sont retournées à partir du cache. Si l’élément demandé n’est pas dans le cache, une erreur appropriée, telle que ERROR_FILE_NOT_FOUND, est retournée. Seule la fonction InternetOpen utilise cet indicateur.

INTERNET_FLAG_PASSIVE

0x08000000

Utilise la sémantique FTP passive. Seuls InternetConnect et InternetOpenUrl utilisent cet indicateur. InternetConnect utilise cet indicateur pour les requêtes FTP, et InternetOpenUrl utilise cet indicateur pour les fichiers et répertoires FTP.

INTERNET_FLAG_PRAGMA_NOCACHE

0x00000100

Force la requête à être résolue par le serveur d’origine, même si une copie mise en cache existe sur le proxy. La fonction InternetOpenUrl (sur les requêtes HTTP et HTTPS uniquement) et la fonction HttpOpenRequest utilisent cet indicateur.

INTERNET_FLAG_RAW_DATA

0x40000000

Retourne les données sous forme de structure WIN32_FIND_DATA lors de la récupération des informations de répertoire FTP. Si cet indicateur n’est pas spécifié ou si l’appel est effectué via un proxy CERN, InternetOpenUrl renvoie la version HTML du répertoire. Seule la fonction InternetOpenUrl utilise cet indicateur.

Windows XP et Windows Server 2003 R2 et versions antérieures : Retourne également une structure GOPHER_FIND_DATA lors de la récupération des informations de répertoire Gopher.

INTERNET_FLAG_READ_PREFETCH

0x00100000

Cet indicateur est actuellement désactivé.

INTERNET_FLAG_RELOAD

0x80000000

Force le téléchargement du fichier, de l’objet ou de la liste de répertoires demandés à partir du serveur d’origine, et non à partir du cache. Les fonctions FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest et InternetOpenUrl utilisent cet indicateur.

Windows XP et Windows Server 2003 R2 et versions antérieures : Également utilisé par GopherFindFirstFile et GopherOpenFile.

INTERNET_FLAG_RESTRICTED_ZONE

0x00020000

Indique que le cookie défini est associé à un site non approuvé.

INTERNET_FLAG_RESYNCHRONIZE

0x00000800

Recharge les ressources HTTP si la ressource a été modifiée depuis le dernier téléchargement. Toutes les ressources FTP sont rechargées. Cet indicateur peut être utilisé par FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest et InternetOpenUrl.

Windows XP et Windows Server 2003 R2 et versions antérieures : Également utilisés par GopherFindFirstFile et GopherOpenFile, et les ressources Gopher sont rechargées.

INTERNET_FLAG_SECURE

0x00800000

Utilise la sémantique de transaction sécurisée. Cela se traduit par l’utilisation du protocole SSL/Private Communications Technology (SSL/PCT) et n’est significatif que dans les requêtes HTTP. Cet indicateur est utilisé par HttpOpenRequest et InternetOpenUrl, mais il est redondant si https:// apparaît dans l’URL. La fonction InternetConnect utilise cet indicateur pour les connexions HTTP ; tous les descripteurs de requête créés dans le cadre de cette connexion héritent de cet indicateur.

INTERNET_FLAG_TRANSFER_ASCII

0x00000001

Transfère le fichier au format ASCII (FTP uniquement). Cet indicateur peut être utilisé par FtpOpenFile, FtpGetFile et FtpPutFile.

INTERNET_FLAG_TRANSFER_BINARY

0x00000002

Transfère le fichier au format binaire (FTP uniquement). Cet indicateur peut être utilisé par FtpOpenFile, FtpGetFile et FtpPutFile.

INTERNET_NO_CALLBACK

0x00000000

Indique qu’aucun rappel ne doit être effectué pour cette API. Il est utilisé pour le paramètre dxContext des fonctions qui autorisent les opérations asynchrones.

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 après l’envoi de la demande 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.

WININET_API_FLAG_ASYNC

0x00000001

Force les opérations asynchrones.

WININET_API_FLAG_SYNC

0x00000004

Force les opérations synchrones.

WININET_API_FLAG_USE_CONTEXT

0x00000008

Force l’API à utiliser la valeur de contexte, même si elle est définie sur zéro.

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