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.