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_CACHE_ENTRY) cookie 条目和普通缓存内容 (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 Services (WinHTTP)
 

注意

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

要求

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

另请参阅

缓存

WinINet 函数