Partager via

FindFirstUrlCacheEntryExA, fonction (wininet.h)

  • Article

Démarre une énumération filtrée du cache Internet.

Syntaxe

HANDLE FindFirstUrlCacheEntryExA(
  [in]      LPCSTR                       lpszUrlSearchPattern,
  [in]      DWORD                        dwFlags,
  [in]      DWORD                        dwFilter,
  [in]      GROUPID                      GroupId,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo,
  [out]     LPVOID                       lpGroupAttributes,
  [in, out] LPDWORD                      lpcbGroupAttributes,
  [in]      LPVOID                       lpReserved
);

Paramètres

[in] lpszUrlSearchPattern

Pointeur vers une chaîne qui contient le modèle de nom source à rechercher. Ce paramètre ne peut être défini que sur « cookie : », « visit : » ou NULL. Définissez ce paramètre sur « cookie : » pour énumérer les cookies ou « visités : » pour énumérer les entrées d’historique des URL dans le cache. Si ce paramètre a la valeur NULL, FindFirstUrlCacheEntryEx retourne toutes les entrées de contenu dans le cache.

[in] dwFlags

Contrôle l’énumération. Aucun indicateur n’est actuellement implémenté ; ce paramètre doit être défini sur zéro.

[in] dwFilter

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 paramètre peut être égal à zéro ou plusieurs indicateurs de propriété suivants, et les indicateurs de type de cache répertoriés ci-dessous.

Valeur Signification
COOKIE_CACHE_ENTRY
 Entrée du cache de cookie.
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.
NORMAL_CACHE_ENTRY
 Entrée de cache normale ; peut être supprimé pour récupérer de l’espace pour les nouvelles entrées.
SPARSE_CACHE_ENTRY
 Entrée du cache de réponse partielle.
STICKY_CACHE_ENTRY
 Entrée de cache sticky ; exempt de se venger.
TRACK_OFFLINE_CACHE_ENTRY
 Non implémenté actuellement.
TRACK_ONLINE_CACHE_ENTRY
 Non implémenté actuellement.
URLHISTORY_CACHE_ENTRY
 Entrée du cache de liens visité.

[in] GroupId

ID du groupe de cache à énumérer. Définissez ce paramètre sur zéro pour énumérer toutes les entrées qui ne sont pas regroupées.

[out] lpFirstCacheEntryInfo

Pointeur vers une structure INTERNET_CACHE_ENTRY_INFO pour recevoir les informations d’entrée du cache.

[in, out] lpcbCacheEntryInfo

Pointeur vers la variable qui indique la taille de la structure référencée par le paramètre lpFirstCacheEntryInfo, en octets.

[out] lpGroupAttributes

Ce paramètre est réservé et doit être NULL.

[in, out] lpcbGroupAttributes

Ce paramètre est réservé et doit être NULL.

[in] lpReserved

Ce paramètre est réservé et doit être NULL.

Valeur de retour

Retourne un handle valide en cas de réussite ou NULL dans le cas contraire. Pour obtenir des informations d’erreur spécifiques, appelez GetLastError. Si la fonction ne trouve aucun fichier correspondant, GetLastError retourne ERROR_NO_MORE_FILES.

Remarques

Le handle retourné par FindFirstUrlCacheEntryEx est utilisé dans tous les appels suivants à FindNextUrlCacheEntryEx. À la fin de l’énumération, l’application doit appeler FindCloseUrlCache.

Comme tous les autres aspects de l’API WinINet, cette fonction ne peut pas être appelée en toute sécurité à partir de DllMain ou des constructeurs et destructeurs d’objets globaux.

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 FindFirstUrlCacheEntryEx comme 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]
plateforme cible Windows
d’en-tête wininet.h
bibliothèque Wininet.lib
DLL Wininet.dll

Voir aussi

mise en cache

fonctions WinINet