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 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 dwExemptDeltaparameter. The default value set by the CommitUrlCacheEntryfunction 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 DWORDof the file size, in TCHARs.

LastModifiedTime

FILETIMEstructure that contains the last modified time of this URL, in Greenwich mean time format.

ExpireTime

FILETIMEstructure that contains the expiration time of this file, in Greenwich mean time format.

LastAccessTime

FILETIMEstructure 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

FILETIMEstructure 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 lpHeaderInfobuffer, 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

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

See Also