Fonction FindFirstUrlCacheGroup (wininet.h)

Article
03/04/2024

Lance l’énumération des groupes de cache dans le cache Internet.

Syntaxe

HANDLE FindFirstUrlCacheGroup(
  [in]      DWORD   dwFlags,
  [in]      DWORD   dwFilter,
  [in]      LPVOID  lpSearchCondition,
  [in]      DWORD   dwSearchCondition,
  [out]     GROUPID *lpGroupId,
  [in, out] LPVOID  lpReserved
);

Paramètres

[in] dwFlags

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

[in] dwFilter

Filtres à utiliser. Ce paramètre peut être égal à zéro ou à l’une des valeurs suivantes.

Valeur	Signification
CACHEGROUP_SEARCH_ALL	Effectuez une recherche dans tous les groupes de cache.
CACHEGROUP_SEARCH_BYURL	Actuellement non implémenté.

[in] lpSearchCondition

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

[in] dwSearchCondition

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

[out] lpGroupId

Pointeur vers l’ID du premier groupe de cache qui correspond aux critères de recherche.

[in, out] lpReserved

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

Valeur retournée

Retourne un handle valide au premier élément de l’énumération 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 FindFirstUrlCacheGroup est utilisé dans les appels suivants à FindNextUrlCacheGroup. À 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).

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]
Plateforme cible	Windows
En-tête	wininet.h
Bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

Mise en cache

Fonctions WinINet