INTERNET_CACHE_ENTRY_INFOA 结构 (wininet.h)

项目
08/27/2023

包含有关 Internet 缓存中的项的信息。

语法

typedef struct _INTERNET_CACHE_ENTRY_INFOA {
  DWORD    dwStructSize;
  LPSTR    lpszSourceUrlName;
  LPSTR    lpszLocalFileName;
  DWORD    CacheEntryType;
  DWORD    dwUseCount;
  DWORD    dwHitRate;
  DWORD    dwSizeLow;
  DWORD    dwSizeHigh;
  FILETIME LastModifiedTime;
  FILETIME ExpireTime;
  FILETIME LastAccessTime;
  FILETIME LastSyncTime;
  LPSTR    lpHeaderInfo;
  DWORD    dwHeaderInfoSize;
  LPSTR    lpszFileExtension;
  union {
    DWORD dwReserved;
    DWORD dwExemptDelta;
  };
} INTERNET_CACHE_ENTRY_INFOA, *LPINTERNET_CACHE_ENTRY_INFOA;

成员

dwStructSize

此结构的大小（以字节为单位）。此值可用于帮助确定缓存系统的版本。

lpszSourceUrlName

指向包含 URL 名称的以 null 结尾的字符串的指针。字符串占用此结构末尾的内存区域。

lpszLocalFileName

指向包含本地文件名的以 null 结尾的字符串的指针。字符串占用此结构末尾的内存区域。

CacheEntryType

一个位掩码，指示缓存项的类型及其属性。缓存条目类型包括： (URLHISTORY_CACHE_ENTRY) 历史记录条目、 (COOKIE_CACHE_ENTRY) cookie 条目和普通缓存内容 (NORMAL_CACHE_ENTRY) 。

此成员可以是以下属性标志的零个或多个，以及下面列出的缓存类型标志。

值	含义
EDITED_CACHE_ENTRY	缓存已在外部编辑的入口文件。此缓存项类型不受清理。
SPARSE_CACHE_ENTRY	部分响应缓存条目。
STICKY_CACHE_ENTRY	在 dwExemptDelta 指定的时间内免除清理的粘滞缓存条目。 CommitUrlCacheEntryA 和 CommitUrlCacheEntryW 设置的默认值为一天。
TRACK_OFFLINE_CACHE_ENTRY	目前尚未实现。
TRACK_ONLINE_CACHE_ENTRY	目前尚未实现。

以下列表包含缓存类型标志。

值	含义
COOKIE_CACHE_ENTRY	Cookie 缓存条目。
NORMAL_CACHE_ENTRY	正常缓存条目；可删除，为新条目恢复空间。
URLHISTORY_CACHE_ENTRY	已访问的链接缓存条目。

dwUseCount

当前使用缓存条目的 WinINEet 调用方数。

dwHitRate

检索缓存项的次数。

dwSizeLow

文件大小的低序部分（以字节为单位）。

dwSizeHigh

文件大小的高序部分（以字节为单位）。

LastModifiedTime

包含此 URL 的上次修改时间的 FILETIME 结构，采用格林威治平均时间格式。

ExpireTime

包含此文件的过期时间的 FILETIME 结构，采用格林威治平均时间格式。

LastAccessTime

包含上次访问时间的 FILETIME 结构，采用格林威治平均时间格式。

LastSyncTime

包含上次同步缓存时间的 FILETIME 结构。

lpHeaderInfo

指向包含标头信息的缓冲区的指针。缓冲区占用此结构末尾的内存。

dwHeaderInfoSize

lpHeaderInfo 缓冲区的大小（以 TCHAR 为单位）。

lpszFileExtension

指向字符串的指针，该字符串包含用于以文件的形式检索数据的文件扩展名。字符串占用此结构末尾的内存区域。

dwReserved

dwExemptDelta

上次访问时间的豁免时间（以秒为单位）。

注解

没有缓存条目大小限制，因此需要枚举缓存的应用程序必须准备好分配大小可变的缓冲区。有关详细信息，请参阅使用缓冲区。

注意 WinINet 不支持服务器实现。此外，不应从服务使用它。对于服务器实现或服务，请使用 Microsoft Windows HTTP Services (WinHTTP) 。

注意

wininet.h 标头将 INTERNET_CACHE_ENTRY_INFO 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	wininet.h