FindFirstUrlCacheEntryExFindFirstUrlCacheEntryEx*
*Contents  *Index  *Topic Contents
*Previous Topic: FindFirstUrlCacheEntry
*Next Topic: FindNextUrlCacheEntry

FindFirstUrlCacheEntryEx

HANDLE FindFirstUrlCacheEntryEx (
    IN LPCSTR lpszUrlSearchPattern,
    IN DWORD dwFlags,
    IN DWORD dwFilter,
    IN GROUPID GroupId
    OUT LPINTERNET_CACHE_ENTRY_INFO  lpFirstCacheEntryInfo,
    IN OUT LPDWORD lpdwFirstCacheEntryInfoBufferSize,
    OUT LPVOID lpGroupAttributes,
    IN OUT LPDWORD pcbGroupAttributes,
    IN LPVOID lpReserved
);

Starts a filtered enumeration of the cache.

lpszUrlSearchPattern
String value containing the search pattern. Search patterns are currently not supported, so the value must be set to NULL to indicate all entries with the matching GROUPID.
dwFlags
DWORD value containing the flags controlling the enumeration. No flags are currently implemented. Must be set to zero.
dwFilter
DWORD value that indicates the cache entry types that are allowed. Can be any combination of cache entry types:
NORMAL_CACHE_ENTRY Normal cache entry; can be deleted to recover space for new entries.
SPARSE_CACHE_ENTRY Not currently implemented.
STABLE_CACHE_ENTRY Not currently implemented.
STICKY_CACHE_ENTRY Not currently implemented.

The following list contains the values that indicate what is being cached. Can be one of the following values:
COOKIE_CACHE_ENTRY Cookie cache entry.
OCX_CACHE_ENTRY Not currently implemented.
URLHISTORY_CACHE_ENTRY Visited link cache entry.

GroupId
GROUPID value indicating the cache group to enumerate. Set the value to zero to enumerate all entries that are not grouped.
lpFirstCacheEntryInfo
Address of the buffer to hold the INTERNET_CACHE_ENTRY_INFO structure that the cache entry information will be stored in.
lpdwFirstCacheEntryInfoBufferSize
Address of a DWORD value that indicates the size of lpFirstCacheEntryInfo.
lpGroupAttributes
Must be set to NULL.
pcbGroupAttributes
Must be set to NULL.
lpReserved
Reserved. Must be set to NULL.

At the end of the enumeration, the application should call FindCloseUrlCache.


Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.