GetUrlCacheEntryInfo

  • Article

This function retrieves data about a cache entry.

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_INFO structure that receives data about the cache entry.
  • lpdwCacheEntryInfoBufferSize
    [in, out] Address of an unsigned long integer variable that specifies the lpCacheEntryInfo buffer size, in bytes. When the function returns, the variable contains the number of bytes copied to the buffer, or the required buffer size.

Return Values

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

OS Versions: Windows CE 2.12 and later.
Header: Wininet.h.
Link Library: Wininet.lib.

See Also

SetUrlCacheEntryInfo | INTERNET_CACHE_ENTRY_INFO | WinInet Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.