structure INTERNET_CACHE_ENTRY_INFOA (wininet.h)

Article
11/20/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 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ée de cache sont les suivants : entrées d’historique (URLHISTORY_CACHE_ENTRY), entrées de cookie (COOKIE_CACHE_ENTRY) et contenu mis en cache normal (NORMAL_CACHE_ENTRY).

Ce membre peut être égal à zéro ou plusieurs des indicateurs de propriété suivants, et les 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 du cache de réponse partielle.
STICKY_CACHE_ENTRY	Entrée de cache sticky 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 un jour.
TRACK_OFFLINE_CACHE_ENTRY	Non implémenté actuellement.
TRACK_ONLINE_CACHE_ENTRY	Non implémenté actuellement.

La liste suivante contient les indicateurs de type de cache.

Valeur	Signification
COOKIE_CACHE_ENTRY	Entrée du cache de cookie.
NORMAL_CACHE_ENTRY	Entrée de cache normale ; peut être supprimé pour récupérer de l’espace pour les nouvelles entrées.
URLHISTORY_CACHE_ENTRY	Entrée du cache de liens 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 de l’ordre élevé de la taille du fichier, en octets.

LastModifiedTime

structure FILETIME qui contient l’heure de dernière modification de cette URL, au format de temps moyen de Greenwich.

ExpireTime

structure FILETIME qui contient l’heure d’expiration de ce fichier, au format de temps moyen de Greenwich.

LastAccessTime

structure FILETIME qui contient l’heure la dernière accessible, au format de temps moyen 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 dans 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 la dernière heure consultée, en secondes.

Remarques

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

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

Note

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	wininet.h