通过

FindFirstUrlCacheEntryA 函数 （wininet.h）

  • 项目

开始枚举 Internet 缓存。

语法

HANDLE FindFirstUrlCacheEntryA(
  [in]      LPCSTR                       lpszUrlSearchPattern,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo
);

参数

[in] lpszUrlSearchPattern

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

[out] lpFirstCacheEntryInfo

指向 INTERNET_CACHE_ENTRY_INFO 结构的指针。

[in, out] lpcbCacheEntryInfo

指向一个变量的指针，该变量指定 lpFirstCacheEntryInfo 缓冲区的大小（以字节为单位）。 函数返回时，变量包含复制到缓冲区的字节数，或检索缓存项所需的大小（以字节为单位）。

返回值

返回应用程序可以在 FindNextUrlCacheEntry 函数中使用的句柄来检索缓存中的后续条目。 如果函数失败，则返回值 NULL。 若要获取扩展的错误信息，请调用 GetLastError。

ERROR_INSUFFICIENT_BUFFER指示由 lpdwFirstCacheEntryInfo 指定的 lpFirstCacheEntryInfoBufferS ize 的大小不足以包含所有信息。 lpdwFirstCacheEntryInfoBufferSize 中返回的值 指示包含所有信息所需的缓冲区大小。

言论

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

FindFirstUrlCacheEntry 和 FindNextUrlCacheEntry 返回可变大小信息。 如果返回ERROR_INSUFFICIENT_BUFFER，应用程序应分配由 lpdwFirstCacheEntryInfoBufferSize指定的大小的缓冲区。 有关详细信息，请参阅 使用缓冲区。

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

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

注意

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

要求

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

另请参阅

缓存

WinINet 函数