FindFirstUrlCacheGroup 函数 (wininet.h)

  • 项目

启动 Internet 缓存中缓存组的枚举。

语法

HANDLE FindFirstUrlCacheGroup(
  [in]      DWORD   dwFlags,
  [in]      DWORD   dwFilter,
  [in]      LPVOID  lpSearchCondition,
  [in]      DWORD   dwSearchCondition,
  [out]     GROUPID *lpGroupId,
  [in, out] LPVOID  lpReserved
);

参数

[in] dwFlags

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

[in] dwFilter

要使用的筛选器。 此参数可以是零或以下值之一。

值 含义
CACHEGROUP_SEARCH_ALL
 搜索所有缓存组。
CACHEGROUP_SEARCH_BYURL
 目前尚未实现。

[in] lpSearchCondition

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

[in] dwSearchCondition

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

[out] lpGroupId

指向与搜索条件匹配的第一个缓存组的 ID 的指针。

[in, out] lpReserved

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

返回值

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

注解

从 FindFirstUrlCacheGroup 返回的句柄用于对 FindNextUrlCacheGroup 的后续调用。 在枚举结束时，应用程序应调用 FindCloseUrlCache。

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

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

要求

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

另请参阅

缓存

WinINet 函数