INTERNET_CACHE_ENTRY_INFOA结构（wininet.h）

项目
11/20/2024

包含有关 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 条目（COOKIE_CACHE_ENTRY）和普通缓存内容（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

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

ExpireTime

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

LastAccessTime

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

LastSyncTime

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

lpHeaderInfo

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

dwHeaderInfoSize

TCHA中 lpHeaderInfo 缓冲区的大小。

lpszFileExtension

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

dwReserved

dwExemptDelta

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

言论

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

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

注意

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

要求

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