INTERNET_CACHE_ENTRY_INFOW structure (wininet.h)

Article
08/27/2023

Contient des informations sur une entrée dans le cache Internet.

Syntaxe

typedef struct _INTERNET_CACHE_ENTRY_INFOW {
  DWORD    dwStructSize;
  LPWSTR   lpszSourceUrlName;
  LPWSTR   lpszLocalFileName;
  DWORD    CacheEntryType;
  DWORD    dwUseCount;
  DWORD    dwHitRate;
  DWORD    dwSizeLow;
  DWORD    dwSizeHigh;
  FILETIME LastModifiedTime;
  FILETIME ExpireTime;
  FILETIME LastAccessTime;
  FILETIME LastSyncTime;
  LPWSTR   lpHeaderInfo;
  DWORD    dwHeaderInfoSize;
  LPWSTR   lpszFileExtension;
  union {
    DWORD dwReserved;
    DWORD dwExemptDelta;
  };
} INTERNET_CACHE_ENTRY_INFOW, *LPINTERNET_CACHE_ENTRY_INFOW;

Membres

dwStructSize

Taille de cette structure, en octets. Cette valeur peut être utilisée pour déterminer la version du système de cache.

lpszSourceUrlName

Pointeur vers une chaîne terminée par null qui contient le nom de l’URL. La chaîne occupe la zone mémoire à la fin de cette structure.

lpszLocalFileName

Pointeur vers une chaîne terminée par null qui contient le nom de fichier local. La chaîne occupe la zone mémoire à la fin de cette structure.

CacheEntryType

Masque de bits indiquant le type d’entrée de cache et ses propriétés. Les types d’entrées de cache incluent : les entrées d’historique (URLHISTORY_CACHE_ENTRY), les entrées de cookie (COOKIE_CACHE_ENTRY) et le contenu mis en cache normal (NORMAL_CACHE_ENTRY).

Ce membre peut être égal à zéro ou plusieurs des indicateurs de propriété suivants et aux indicateurs de type de cache répertoriés ci-dessous.

Valeur	Signification
EDITED_CACHE_ENTRY	Fichier d’entrée de cache qui a été modifié en externe. Ce type d’entrée de cache est exempt de nettoyage.
SPARSE_CACHE_ENTRY	Entrée de cache de réponse partielle.
STICKY_CACHE_ENTRY	Entrée de cache collant qui est exempte de la casse pendant la durée spécifiée par dwExemptDelta. La valeur par défaut définie par CommitUrlCacheEntryA et CommitUrlCacheEntryW est un jour.
TRACK_OFFLINE_CACHE_ENTRY	Actuellement non implémenté.
TRACK_ONLINE_CACHE_ENTRY	Actuellement non implémenté.

La liste suivante contient les indicateurs de type de cache.

Valeur	Signification
COOKIE_CACHE_ENTRY	Entrée de cache de cookie.
NORMAL_CACHE_ENTRY	Entrée de cache normale ; peut être supprimée pour récupérer de l’espace pour de nouvelles entrées.
URLHISTORY_CACHE_ENTRY	Entrée de cache de lien visité.

dwUseCount

Nombre actuel d’appelants WinINEet utilisant l’entrée de cache.

dwHitRate

Nombre de fois que l’entrée de cache a été récupérée.

dwSizeLow

Partie d’ordre faible de la taille du fichier, en octets.

dwSizeHigh

Partie d’ordre élevé de la taille de fichier, en octets.

LastModifiedTime

STRUCTURE FILETIME qui contient l’heure de la dernière modification de cette URL, au format d’heure moyenne de Greenwich.

ExpireTime

STRUCTURE FILETIME qui contient l’heure d’expiration de ce fichier, au format d’heure moyenne de Greenwich.

LastAccessTime

STRUCTURE FILETIME qui contient l’heure du dernier accès, au format d’heure moyenne de Greenwich.

LastSyncTime

STRUCTURE FILETIME qui contient l’heure de la dernière synchronisation du cache.

lpHeaderInfo

Pointeur vers une mémoire tampon qui contient les informations d’en-tête. La mémoire tampon occupe la mémoire à la fin de cette structure.

dwHeaderInfoSize

Taille de la mémoire tampon lpHeaderInfo , en TCHAR.

lpszFileExtension

Pointeur vers une chaîne qui contient l’extension de nom de fichier utilisée pour récupérer les données en tant que fichier. La chaîne occupe la zone mémoire à la fin de cette structure.

dwReserved

dwExemptDelta

Heure d’exemption de l’heure du dernier accès, en secondes.

Remarques

Il n’existe aucune limite de taille d’entrée du cache. Les applications qui doivent énumérer le cache doivent donc être préparées pour allouer des mémoires tampons de taille variable. Pour plus d’informations, consultez Utilisation de tampons.

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_CACHE_ENTRY_INFO 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