通过

FindFirstUrlCacheEntryExA 函数 （wininet.h）

  • 项目

启动经过筛选的 Internet 缓存枚举。

语法

HANDLE FindFirstUrlCacheEntryExA(
  [in]      LPCSTR                       lpszUrlSearchPattern,
  [in]      DWORD                        dwFlags,
  [in]      DWORD                        dwFilter,
  [in]      GROUPID                      GroupId,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo,
  [out]     LPVOID                       lpGroupAttributes,
  [in, out] LPDWORD                      lpcbGroupAttributes,
  [in]      LPVOID                       lpReserved
);

参数

[in] lpszUrlSearchPattern

指向包含要搜索的源名称模式的字符串的指针。 此参数只能设置为“cookie：”、“visited：”或 NULL。 将此参数设置为“cookie：”以枚举 Cookie 或“visited：”以枚举缓存中的 URL 历史记录条目。 如果此参数为 NULL，FindFirstUrlCacheEntryEx 返回缓存中的所有内容条目。

[in] dwFlags

控制枚举。 当前未实现任何标志;此参数必须设置为零。

[in] dwFilter

指示缓存项的类型及其属性的位掩码。 缓存项类型包括：历史记录项（URLHISTORY_CACHE_ENTRY）、Cookie 条目（COOKIE_CACHE_ENTRY）和普通缓存内容（NORMAL_CACHE_ENTRY）。

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

价值 意义
COOKIE_CACHE_ENTRY
 Cookie 缓存条目。
EDITED_CACHE_ENTRY
 缓存已在外部编辑的条目文件。 此缓存条目类型不受清理的豁免。
NORMAL_CACHE_ENTRY
 普通缓存条目;可以删除以恢复新条目的空间。
SPARSE_CACHE_ENTRY
 部分响应缓存条目。
STICKY_CACHE_ENTRY
 粘滞缓存条目;免除清理。
TRACK_OFFLINE_CACHE_ENTRY
 当前未实现。
TRACK_ONLINE_CACHE_ENTRY
 当前未实现。
URLHISTORY_CACHE_ENTRY
 已访问的链接缓存条目。

[in] GroupId

要枚举的缓存组的 ID。 将此参数设置为零以枚举未分组的所有条目。

[out] lpFirstCacheEntryInfo

指向 INTERNET_CACHE_ENTRY_INFO 结构的指针，用于接收缓存条目信息。

[in, out] lpcbCacheEntryInfo

指向指示由 lpFirstCacheEntryInfo 参数引用的结构大小的变量的指针，以字节为单位。

[out] lpGroupAttributes

此参数是保留的，必须为 NULL。

[in, out] lpcbGroupAttributes

此参数是保留的，必须为 NULL。

[in] lpReserved

此参数是保留的，必须为 NULL。

返回值

如果成功，则返回有效的句柄，否则返回 NULL。 若要获取特定错误信息，请调用 GetLastError。 如果函数找不到匹配的文件，GetLastError 返回ERROR_NO_MORE_FILES。

言论

从 FindFirstUrlCacheEntryEx 返回的句柄用于对 findNextUrlCacheEntryEx的所有后续 调用。 枚举结束时，应用程序应调用 FindCloseUrlCache。

与 WinINet API 的其他所有方面一样，不能从 DllMain 或全局对象的构造函数和析构函数中安全地调用此函数。

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

注意

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

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 wininet.h
库 Wininet.lib
DLL Wininet.dll

另请参阅

缓存

WinINet 函数