FindFirstUrlCacheEntryExW 函数 (wininet.h)
启动 Internet 缓存的筛选枚举。
语法
HANDLE FindFirstUrlCacheEntryExW(
[in] LPCWSTR lpszUrlSearchPattern,
[in] DWORD dwFlags,
[in] DWORD dwFilter,
[in] GROUPID GroupId,
[out] LPINTERNET_CACHE_ENTRY_INFOW 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 缓存条目。 |
|
缓存已在外部编辑的条目文件。 此缓存条目类型不受清理。 |
|
正常缓存条目;可删除,为新条目恢复空间。 |
|
部分响应缓存条目。 |
|
置顶缓存条目;免于清理。 |
|
目前尚未实现。 |
|
目前尚未实现。 |
|
已访问的链接缓存条目。 |
[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.h 标头将 FindFirstUrlCacheEntryEx 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | wininet.h |
Library | Wininet.lib |
DLL | Wininet.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈