Fonction FindFirstUrlCacheEntryExA (wininet.h)
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 |
---|---|
|
Entrée de cache de cookie. |
|
Fichier d’entrée de cache qui a été modifié en externe. Ce type d’entrée de cache est exempt de la casse. |
|
Entrée de cache normale ; peut être supprimée pour récupérer de l’espace pour de nouvelles entrées. |
|
Entrée de cache de réponse partielle. |
|
Entrée de cache permanent ; exempte de nettoyage. |
|
Actuellement non implémenté. |
|
Actuellement non implémenté. |
|
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.
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 |