Contents Index Topic Contents | ||
Previous Topic: FindNextUrlCacheEntryEx Next Topic: GetUrlCacheEntryInfoEx |
GetUrlCacheEntryInfo
BOOL GetUrlCacheEntryInfo( IN LPCSTR lpszUrlName, IN LPINTERNET_CACHE_ENTRY_INFO lpCacheEntryInfo, IN OUT LPDWORD lpdwCacheEntryInfoBufferSize );Retrieves information about a cache entry.
- Returns TRUE if successful, or FALSE otherwise. To get extended error information, call GetLastError. Possible error values include:
ERROR_FILE_NOT_FOUND The specified cache entry is not found in the cache. ERROR_INSUFFICIENT_BUFFER The size of lpCacheEntryInfo as specified by lpdwCacheEntryInfoBufferSize is not sufficient to contain all the information. The value returned in lpdwCacheEntryInfoBufferSize indicates the buffer size necessary to contain all the information.
- lpszUrlName
- Address of a string that contains the name of the cache entry. The name string should not contain any escape characters.
- lpCacheEntryInfo
- Address of an INTERNET_CACHE_ENTRY_INFO structure that receives information about the cache entry.
- lpdwCacheEntryInfoBufferSize
- Address of a variable that specifies the size of the lpCacheEntryInfo buffer. When the function returns, the variable contains the number of bytes copied to the buffer, or the required size of the buffer.
GetUrlCacheEntryInfo does not do any URL parsing, 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.
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.