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.

• Returns a valid handle if successful, or NULL otherwise. To get specific error information, use GetLastError. If the function finds no matching files, GetLastError returns ERROR_NO_MORE_FILES.

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.

---

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