Fonction FindFirstUrlCacheEntryExA (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 peut uniquement être défini sur « cookie: », « visité : » ou NULL. Définissez ce paramètre sur « cookie : » pour énumérer les cookies ou « visité : » pour énumérer les entrées d’historique d’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é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 paramètre 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
COOKIE_CACHE_ENTRY
 Entrée de 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ée pour récupérer de l’espace pour de nouvelles entrées.
SPARSE_CACHE_ENTRY
 Entrée de cache de réponse partielle.
STICKY_CACHE_ENTRY
 Entrée de cache permanent ; exempte de nettoyage.
TRACK_OFFLINE_CACHE_ENTRY
 Actuellement non implémenté.
TRACK_ONLINE_CACHE_ENTRY
 Actuellement non implémenté.
URLHISTORY_CACHE_ENTRY
 Entrée de cache de lien 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 avoir la valeur NULL.

[in, out] lpcbGroupAttributes

Ce paramètre est réservé et doit avoir la valeur NULL.

[in] lpReserved

Ce paramètre est réservé et doit avoir la valeur NULL.

Valeur retournée

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.

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

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête wininet.h
Bibliothèque Wininet.lib
DLL Wininet.dll

Voir aussi

Mise en cache

Fonctions WinINet