FindNextUrlCacheEntry Function

Retrieves the next entry in the Internet cache.

Syntax

BOOL FindNextUrlCacheEntry%(
    IN HANDLE hEnumHandle,
    OUT LPINTERNET_CACHE_ENTRY_INFO% lpNextCacheEntryInfo,
    IN OUT LPWORD lpdwNextCacheEntryInfoBufferSize
);

The actual syntax of this function varies between its ANSI and Unicode implementations. See the Win32 Internet Functions Syntax document for details.

Parameters

hEnumHandle

Enumeration handle obtained from a previous call to FindFirstUrlCacheEntry.

lpNextCacheEntryInfo

Address of an INTERNET_CACHE_ENTRY_INFO structure that receives information about the cache entry.

lpdwNextCacheEntryInfoBufferSize

Address of an unsigned long integer variable that specifies the size of the lpNextCacheEntryInfo buffer. When the function returns, the variable contains the number of bytes copied to the buffer, or the required size of the buffer.

Return Value

Returns TRUE if successful, or FALSE otherwise. To get extended error information, call GetLastError. Possible error values include:

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.

Function Information

Windows NT	Use version 4.0 and later. Implemented as ANSI and Unicode functions.
Windows	Use Windows 95 and later. Implemented as ANSI and Unicode functions.
Header	Wininet.h
Import library	Wininet.lib
Minimum availability	Internet Explorer 3.0 (ANSI only), 5 (ANSI and Unicode)

See Also

Microsoft Win32 Internet Functions Overview, Caching, Microsoft Win32 Internet Functions Reference, Persistent URL Cache Functions

Does this content meet your programming needs? Write us!

Back to top