WinINet Functions


FindNextUrlCacheEntry Function

Retrieves the next entry in the Internet cache.

Syntax

C++
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 codeDescription
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 clientWindows 2000 Professional
Minimum supported serverWindows 2000 Server
VersionInternet Explorer 3.0 or later
HeaderWininet.h
LibraryWininet.lib
DLLWininet.dll
Unicode and ANSI namesFindNextUrlCacheEntryW (Unicode) and FindNextUrlCacheEntryA (ANSI)

See Also

Caching
WinINet Functions

Send comments about this topic to Microsoft

Build date: 11/19/2009

Tags :


Page view tracker