INTERNET_CACHE_ENTRY_INFO

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains information about an entry in the Internet cache.

Syntax

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

Members

• dwStructSize
  Unsigned long integer value that contains the size, in TCHARs, of this structure. This value can be used to help determine the version of the cache system.

• lpszSourceUrlName
  Address of a string that contains the URL name. The string occupies the memory area at the end of this structure.

• lpszLocalFileName
  Address of a string that contains the local file name. The string occupies the memory area at the end of this structure.

• CacheEntryType
  Unsigned long integer value that contains the 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 following table shows values that determine how the cache entry is handled.

  Value	Description
  EDITED_CACHE_ENTRY	The cache entry has been altered since it was downloaded from the Internet.
  NORMAL_CACHE_ENTRY	A normal cache entry, which can be deleted to recover space for new entries.
  SPARSE_CACHE_ENTRY	Not currently implemented.
  STICKY_CACHE_ENTRY	A sticky cache entry that is exempt from scavenging for the amount of time specified by the dwExemptDelta parameter. The default value set by the CommitUrlCacheEntry function is one day.

• dwUseCount
  Unsigned long integer value that contains the current user count of the cache entry.

• dwHitRate
  Unsigned long integer value that contains the number of times the cache entry was retrieved.

• dwSizeLow
  Unsigned long integer value that contains the low order of the file size, in TCHARs.

• dwSizeHigh
  Unsigned long integer value that contains the high-order DWORD of the file size, in TCHARs.

• LastModifiedTime
  FILETIME structure that contains the last modified time of this URL, in Greenwich mean time format.

• ExpireTime
  FILETIME structure that contains the expiration time of this file, in Greenwich mean time format.

• LastAccessTime
  FILETIME structure that contains the last accessed time, in Greenwich mean time format. This member is not supported by a file allocation table (FAT) file system on CE.

• LastSyncTime
  FILETIME structure that contains the last time the cache was synchronized.

• lpHeaderInfo
  Address of a buffer that contains the header information. The buffer occupies the memory at the end of this structure.

• dwHeaderInfoSize
  Unsigned long integer value that contains the size of the lpHeaderInfo buffer, in TCHARs.

• lpszFileExtension
  Address of a string that contains the file extension used to retrieve the data as a file. The string occupies the memory area at the end of this structure.

• dwReserved
  Reserved. Must be set to zero.

• dwExemptDelta
  Unsigned long integer value that contains the exemption time, in seconds, from the last accessed time.

Remarks

There is no cache entry size limit, so applications that need to enumerate the cache must be prepared to allocate variable-sized buffers.

Requirements

See Also

Reference

CommitUrlCacheEntry
WinInet Structures

Other Resources

FILETIME