Skip to content

Latest commit

 

History

History
277 lines (194 loc) · 8.97 KB

ns-wininet-internet_cache_entry_infoa.md

File metadata and controls

277 lines (194 loc) · 8.97 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:wininet._INTERNET_CACHE_ENTRY_INFOA
INTERNET_CACHE_ENTRY_INFOA (wininet.h)
Contains information about an entry in the Internet cache. (ANSI)
*LPINTERNET_CACHE_ENTRY_INFOA
COOKIE_CACHE_ENTRY
EDITED_CACHE_ENTRY
INTERNET_CACHE_ENTRY_INFO
INTERNET_CACHE_ENTRY_INFO structure [WinINet]
INTERNET_CACHE_ENTRY_INFOA
INTERNET_CACHE_ENTRY_INFOW
LPINTERNET_CACHE_ENTRY_INFO
LPINTERNET_CACHE_ENTRY_INFO structure pointer [WinINet]
NORMAL_CACHE_ENTRY
SPARSE_CACHE_ENTRY
STICKY_CACHE_ENTRY
TRACK_OFFLINE_CACHE_ENTRY
TRACK_ONLINE_CACHE_ENTRY
URLHISTORY_CACHE_ENTRY
_inet_internet_cache_entry_info_structure
wininet.internet_cache_entry_info
wininet/INTERNET_CACHE_ENTRY_INFO
wininet/INTERNET_CACHE_ENTRY_INFOA
wininet/INTERNET_CACHE_ENTRY_INFOW
wininet/LPINTERNET_CACHE_ENTRY_INFO
wininet\internet_cache_entry_info.htm
wininet
7bda08e0-5df0-4087-a5cd-3a25c6ae5ade
12/05/2018
*LPINTERNET_CACHE_ENTRY_INFOA, COOKIE_CACHE_ENTRY, EDITED_CACHE_ENTRY, INTERNET_CACHE_ENTRY_INFO, INTERNET_CACHE_ENTRY_INFO structure [WinINet], INTERNET_CACHE_ENTRY_INFOA, INTERNET_CACHE_ENTRY_INFOW, LPINTERNET_CACHE_ENTRY_INFO, LPINTERNET_CACHE_ENTRY_INFO structure pointer [WinINet], NORMAL_CACHE_ENTRY, SPARSE_CACHE_ENTRY, STICKY_CACHE_ENTRY, TRACK_OFFLINE_CACHE_ENTRY, TRACK_ONLINE_CACHE_ENTRY, URLHISTORY_CACHE_ENTRY, _inet_internet_cache_entry_info_structure, wininet.internet_cache_entry_info, wininet/INTERNET_CACHE_ENTRY_INFO, wininet/INTERNET_CACHE_ENTRY_INFOA, wininet/INTERNET_CACHE_ENTRY_INFOW, wininet/LPINTERNET_CACHE_ENTRY_INFO
wininet.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
INTERNET_CACHE_ENTRY_INFOW (Unicode) and INTERNET_CACHE_ENTRY_INFOA (ANSI)
Windows
INTERNET_CACHE_ENTRY_INFOA, *LPINTERNET_CACHE_ENTRY_INFOA
19H1
_INTERNET_CACHE_ENTRY_INFOA
wininet/_INTERNET_CACHE_ENTRY_INFOA
LPINTERNET_CACHE_ENTRY_INFOA
wininet/LPINTERNET_CACHE_ENTRY_INFOA
INTERNET_CACHE_ENTRY_INFOA
wininet/INTERNET_CACHE_ENTRY_INFOA
c++
APIRef
kbSyntax
HeaderDef
Wininet.h
INTERNET_CACHE_ENTRY_INFO
INTERNET_CACHE_ENTRY_INFOA
INTERNET_CACHE_ENTRY_INFOW

INTERNET_CACHE_ENTRY_INFOA structure

-description

Contains information about an entry in the Internet cache.

-struct-fields

-field dwStructSize

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

-field lpszSourceUrlName

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

-field 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.

-field 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.

Value Meaning
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.

Value Meaning
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.

-field dwUseCount

Current number of WinINEet callers using the cache entry.

-field dwHitRate

Number of times the cache entry was retrieved.

-field dwSizeLow

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

-field dwSizeHigh

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

-field LastModifiedTime

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

-field ExpireTime

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

-field LastAccessTime

FILETIME structure that contains the last accessed time, in Greenwich mean time format.

-field LastSyncTime

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

-field lpHeaderInfo

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

-field dwHeaderInfoSize

Size of the lpHeaderInfo buffer, in TCHARs.

-field 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.

-field dwReserved

-field 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).
 

Note

The wininet.h header defines INTERNET_CACHE_ENTRY_INFO as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

-see-also

FindFirstUrlCacheEntry

FindFirstUrlCacheEntryEx

FindNextUrlCacheEntry

FindNextUrlCacheEntryEx

GetUrlCacheEntryInfo

GetUrlCacheEntryInfoEx

SetUrlCacheEntryInfo