Export (0) Print
Expand All
2 out of 3 rated this helpful - Rate this topic

INTERNET_CACHE_ENTRY_INFO 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;
  LPTSTR   lpHeaderInfo;
  DWORD    dwHeaderInfoSize;
  LPTSTR   lpszFileExtension;
  union {
    DWORD dwReserved;
    DWORD dwExemptDelta;
  };
} INTERNET_CACHE_ENTRY_INFO, *LPINTERNET_CACHE_ENTRY_INFO;

Members

dwStructSize

Size of this structure, in bytes. This value can be used to help determine the version of the cache system.

lpszSourceUrlName

Pointer to a null-terminated string that contains the URL name. The string occupies the memory area at the end of this structure.

lpszLocalFileName

Pointer to a null-terminated string that contains the local file name. The string occupies the memory area at the end of this structure.

CacheEntryType

A bitmask indicating the type of cache entry and its properties. The cache entry types include: history entries (URLHISTORY_CACHE_ENTRY), cookie entries (COOKIE_CACHE_ENTRY), and normal cached content (NORMAL_CACHE_ENTRY).

This member can be zero or more of the following property flags, and cache type flags listed below.

ValueMeaning
EDITED_CACHE_ENTRY

Cache entry file that has been edited externally. This cache entry type is exempt from scavenging.

SPARSE_CACHE_ENTRY

Partial response cache entry.

STICKY_CACHE_ENTRY

Sticky cache entry that is exempt from scavenging for the amount of time specified by dwExemptDelta. The default value set by CommitUrlCacheEntryA and CommitUrlCacheEntryW is one day.

TRACK_OFFLINE_CACHE_ENTRY

Not currently implemented.

TRACK_ONLINE_CACHE_ENTRY

Not currently implemented.

 

The following list contains the cache type flags.

ValueMeaning
COOKIE_CACHE_ENTRY

Cookie cache entry.

NORMAL_CACHE_ENTRY

Normal cache entry; can be deleted to recover space for new entries.

URLHISTORY_CACHE_ENTRY

Visited link cache entry.

 

dwUseCount

Current number of WinINEet callers using the cache entry.

dwHitRate

Number of times the cache entry was retrieved.

dwSizeLow

Low-order portion of the file size, in bytes.

dwSizeHigh

High-order portion of the file size, in bytes.

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.

LastSyncTime

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

lpHeaderInfo

Pointer to a buffer that contains the header information. The buffer occupies the memory at the end of this structure.

dwHeaderInfoSize

Size of the lpHeaderInfo buffer, in TCHARs.

lpszFileExtension

Pointer to a string that contains the file name 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 zero.
dwExemptDelta

Exemption time from the last accessed time, in seconds.

Remarks

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 Using Buffers.

Note  WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wininet.h

Unicode and ANSI names

INTERNET_CACHE_ENTRY_INFOW (Unicode) and INTERNET_CACHE_ENTRY_INFOA (ANSI)

See also

FindFirstUrlCacheEntry
FindFirstUrlCacheEntryEx
FindNextUrlCacheEntry
FindNextUrlCacheEntryEx
GetUrlCacheEntryInfo
GetUrlCacheEntryInfoEx
SetUrlCacheEntryInfo

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.