structure INTERNET_CACHE_ENTRY_INFOA (wininet.h)

Article
03/04/2024

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

Syntaxe

typedef struct _INTERNET_CACHE_ENTRY_INFOA {
  DWORD    dwStructSize;
  LPSTR    lpszSourceUrlName;
  LPSTR    lpszLocalFileName;
  DWORD    CacheEntryType;
  DWORD    dwUseCount;
  DWORD    dwHitRate;
  DWORD    dwSizeLow;
  DWORD    dwSizeHigh;
  FILETIME LastModifiedTime;
  FILETIME ExpireTime;
  FILETIME LastAccessTime;
  FILETIME LastSyncTime;
  LPSTR    lpHeaderInfo;
  DWORD    dwHeaderInfoSize;
  LPSTR    lpszFileExtension;
  union {
    DWORD dwReserved;
    DWORD dwExemptDelta;
  };
} INTERNET_CACHE_ENTRY_INFOA, *LPINTERNET_CACHE_ENTRY_INFOA;

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 d’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 cookies (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 la casse.
SPARSE_CACHE_ENTRY	Entrée de cache de réponse partielle.
STICKY_CACHE_ENTRY	Entrée de cache collante qui est exemptée de la casse pendant la durée spécifiée par dwExemptDelta. La valeur par défaut définie par CommitUrlCacheEntryA et CommitUrlCacheEntryW est d’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 où l’entrée du cache a été récupérée.

dwSizeLow

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

dwSizeHigh

Partie d’ordre élevé de la taille du 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 de la dernière consultation, au format d’heure moyenne de Greenwich.

LastSyncTime

STRUCTURE FILETIME qui contient 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êtes à allouer des mémoires tampons de taille variable. Pour plus d’informations, consultez Utilisation de mémoires 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 comme un 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. Le mélange 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