Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function retrieves data about a cache entry.

Syntax

BOOL GetUrlCacheEntryInfo( 
  LPCTSTR
 lpszUrlName,
  LPINTERNET_CACHE_ENTRY_INFO
 lpCacheEntryInfo,
  LPDWORD 
lpdwCacheEntryInfoBufferSize
);

Parameters

lpszUrlName

[in] Address of a string that contains the cache entry name. This string should not contain escape characters.

lpCacheEntryInfo

[in] Address of an INTERNET_CACHE_ENTRY_INFOstructure that receives data about the cache entry.

lpdwCacheEntryInfoBufferSize

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

Return Value

Returns TRUE if successful, or FALSE otherwise.

Remarks

This function does not parse a Uniform Resource Locator (URL), so a URL containing an anchor (#) will not be found in the cache, even if the resource is cached. For example, if the URL http://example.com/example.htm#sample was passed, the function would return ERROR_FILE_NOT_FOUND even if http://example.com/example.htm is in the cache.

Requirements

Header wininet.h
Library wininet.lib
Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also