FindFirstUrlCacheEntryEx
This function begins a filtered enumeration of the Internet cache.
HANDLE FindFirstUrlCacheEntryEx(
LPCWSTR lpszUrlSearchPattern,
DWORD dwFlags,
DWORD dwFilter,
GROUPID GroupId,
LPINTERNET_CACHE_ENTRY_INFO lpFirstCacheEntryInfo,
LPDWORD lpdwFirstCacheEntryInfoBufferSize,
LPVOID lpGroupAttributes,
LPDWORD pcbGroupAttributes,
LPVOID lpReserved);
Parameters
lpszUrlSearchPattern
[in] Address of a string that contains the source name pattern to search for. This can be set to "cookie:" or "visited:" to enumerate the cookies and Uniform Resource Locator (URL) History entries in the cache. If this parameter is NULL, the function uses *.*.dwFlags
[in] Unsigned long integer value containing the flags controlling the enumeration. No flags are currently implemented. Must be set to zero.dwFilter
[in] Unsigned long integer value that indicates the cache entry types accepted. This can be a combination of cache entry types:Value Description COOKIE_CACHE_ENTRY Cookie cache entry. NORMAL_CACHE_ENTRY Normal cache entry; can be deleted to recover space for new entries. STICKY_CACHE_ENTRY Sticky cache entry; exempt from scavenging. TRACK_OFFLINE_CACHE_ENTRY Not currently implemented. TRACK_ONLINE_CACHE_ENTRY Not currently implemented. URLHISTORY_CACHE_ENTRY Visited link cache entry. GroupId
[in] GROUPID value indicating the cache group to enumerate. Set the value to zero to enumerate all entries not grouped.lpFirstCacheEntryInfo
[out] Address of an INTERNET_CACHE_ENTRY_INFO structure.lpdwFirstCacheEntryInfoBufferSize
[in/out] Address of an unsigned long integer variable that specifies the lpFirstCacheEntryInfo buffer size, in bytes. When the function returns, the variable contains the number of bytes copied to the buffer, or the required buffer size.lpGroupAttributes
Reserved; set to NULL.pcbGroupAttributes
Reserved; set to NULL.lpReserved
Reserved; set to NULL.
Return Values
Returns a valid handle if successful, or NULL otherwise
Remarks
At the end of the enumeration, the application should call FindCloseUrlCache.
Requirements
Runs on | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | Wininet.h | Wininet.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
FindCloseUrlCache, FindNextUrlCacheEntry, INTERNET_CACHE_ENTRY_INFO
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.