Retrieves the next entry in the Internet cache.
Syntax
BOOLAPI FindNextUrlCacheEntry(
__in HANDLE hEnumHandle,
__out LPINTERNET_CACHE_ENTRY_INFO lpNextCacheEntryInfo,
__inout LPDWORD lpcbCacheEntryInfo
);
Parameters
- hEnumHandle [in]
-
Handle to the enumeration obtained from a previous call to
FindFirstUrlCacheEntry.
- lpNextCacheEntryInfo [out]
-
Pointer to an
INTERNET_CACHE_ENTRY_INFO structure that receives information about the cache entry.
- lpcbCacheEntryInfo [in, out]
-
Pointer to a variable that specifies the size of the
lpNextCacheEntryInfo buffer, in TCHARs. When the function returns, the variable contains the number of TCHARs copied to the buffer, or the size of the buffer required to retrieve the cache entry, in bytes.
Return Value
Returns TRUE if successful, or FALSE otherwise. To get extended error information, call
GetLastError. Possible error values include the following.
| Return code | Description |
- ERROR_INSUFFICIENT_BUFFER
| The size of
lpNextCacheEntryInfo as specified by
lpdwNextCacheEntryInfoBufferSize is not sufficient to contain all the information. The value returned in
lpdwNextCacheEntryInfoBufferSize indicates the buffer size necessary to contain all the information.
|
- ERROR_NO_MORE_ITEMS
| The enumeration completed.
|
Remarks
Continue to call FindNextUrlCacheEntry until the last item in the cache is returned.
Requirements
| Minimum supported client | Windows 2000 Professional |
| Minimum supported server | Windows 2000 Server |
| Version | Internet Explorer 3.0 or later |
| Header | Wininet.h |
| Library | Wininet.lib |
| DLL | Wininet.dll |
| Unicode and ANSI names | FindNextUrlCacheEntryW (Unicode) and FindNextUrlCacheEntryA (ANSI) |
See Also
- Caching
- WinINet Functions
Send comments about this topic to Microsoft
Build date: 11/19/2009