INTERNET_CACHE_ENTRY_INFOINTERNET_CACHE_ENTRY_INFO*
*Contents  *Index  *Topic Contents
*Previous Topic: INTERNET_BUFFERS
*Next Topic: INTERNET_CERTIFICATE_INFO

INTERNET_CACHE_ENTRY_INFO

typedef struct _CACHE_ENTRY_INFO {
    DWORD dwStructSize;
    LPSTR lpszSourceUrlName;
    LPSTR lpszLocalFileName;
    DWORD CacheEntryType;
    DWORD dwUseCount;
    DWORD dwHitRate;
    DWORD dwSizeLow;
    DWORD dwSizeHigh;
    FILETIME LastModifiedTime;
    FILETIME ExpireTime;
    FILETIME LastAccessTime;
    FILETIME LastSyncTime;
    LPBYTE lpHeaderInfo;
    DWORD dwHeaderInfoSize;
    LPSTR lpszFileExtension;
    union (DWORD dwReserved; DWORD dwExemptDelta;)
} INTERNET_CACHE_ENTRY_INFO, *LPINTERNET_CACHE_ENTRY_INFO;

Contains information about an entry in the cache.

dwStructSize
Size, in bytes, of this structure.
lpszSourceUrlName
Address of a string that contains the URL name. The string occupies memory area at the end of this structure.
lpszLocalFileName
Address of a string that contains the local file name. The string occupies memory area at the end of this structure.
CacheEntryType
Cache type bitmask. Currently, the cache entry type value of resources from the Internet is equal to zero. For History and Cookie entries, the cache entry type is a combination of two values. One value determines how the cache entry is handled; the second value indicates what is being cached.

The value that determines how the cache entry is handled can be one of the following:
NORMAL_CACHE_ENTRY Normal cache entry; can be deleted to recover space for new entries.
SPARSE_CACHE_ENTRY Not currently implemented.
STABLE_CACHE_ENTRY Not currently implemented.
STICKY_CACHE_ENTRY Sticky cache entry that is exempt from scavenging for amount of time specified by dwExemptDelta. The default value set by CommitUrlCacheEntry is one day.

The value that indicates what is being cached can be one of the following:
COOKIE_CACHE_ENTRY Cookie cache entry.
OCX_CACHE_ENTRY Not currently implemented.
URLHISTORY_CACHE_ENTRY Visited link cache entry.

dwUseCount
Current user count of the cache entry.
dwHitRate
Number of times the cache entry was retrieved.
dwSizeLow
Low-order double word of the file size.
dwSizeHigh
High-order double word of the file size.
LastModifiedTime
Last modified time of this URL, in GMT format.
ExpireTime
Expiration time of this file, in GMT format.
LastAccessTime
Last accessed time, in GMT format.
LastSyncTime
Last time the cache was synchronized.
lpHeaderInfo
Address of a buffer that contains the header information. The buffer occupies memory at the end of this structure.
dwHeaderInfoSize
Size of the lpHeaderInfo buffer.
lpszFileExtension
Address of a string that contains the file extension used to retrieve the data as a file. The string occupies memory area at the end of this structure.
union (DWORD dwReserved; DWORD dwExemptDelta;)
Exemption time, in seconds, from the last accessed time.

There is no cache entry size limit, so applications that need to enumerate the cache must be prepared to allocate variable-sized buffers. For more information, see Appendix B: Using Buffers.


Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.