ResUtilEnumResourcesEx2 函数 (resapi.h)

项目
03/01/2024

枚举指定群集中的所有资源，并为每个资源启动用户定义的操作。 PRESUTIL_ENUM_RESOURCES_EX2类型定义指向此函数的指针。

语法

DWORD ResUtilEnumResourcesEx2(
  [in]           HCLUSTER               hCluster,
  [in, optional] HRESOURCE              hSelf,
  [in]           LPCWSTR                lpszResTypeName,
  [in]           LPRESOURCE_CALLBACK_EX pResCallBack,
  [in]           PVOID                  pParameter,
  [in]           DWORD                  dwDesiredAccess
);

参数

[in] hCluster

包含要枚举的资源的群集的句柄。

[in, optional] hSelf

群集资源的可选句柄。不会为 hSelf 标识的资源调用回调函数。

[in] lpszResTypeName

指向资源类型名称的可选指针，该名称缩小了要枚举的资源范围。如果指定 了 lpszResTypeName ，则仅枚举指定类型的资源。

[in] pResCallBack

指向将为每个枚举资源调用的用户定义函数的指针。此函数必须符合 ResourceCallbackEx 回调函数的定义， (注意参数名称不是定义的一部分;为了清楚) ，已在此处添加它们：

DWORD (*LPRESOURCE_CALLBACK_EX)( 
  HCLUSTER hCluster,
  HRESOURCE hSelf, 
  HRESOURCE hEnum, 
  PVOID pParameter 
);

hCluster

[in]传递给 ResUtilEnumResourcesEx 的 hCluster 参数。

hSelf

[in]传递给 ResUtilEnumResourcesEx 的 hSelf 参数。请注意，当 hSelf 和 hEnum 引用同一资源时，永远不会调用回调函数。

hEnum

[in]当前枚举的资源的句柄。 ResUtilEnumResourcesEx 会自动打开和关闭此句柄。

pParameter

[in]一个泛型缓冲区，可用于将任何类型的数据传递给回调函数。

[in] pParameter

一个泛型缓冲区，可用于将任何类型的数据传递给回调函数。 ResUtilEnumResourcesEx 根本不使用此参数，它只传递指向回调函数的指针。是否可以为参数传递 NULL 取决于回调函数的实现方式。

[in] dwDesiredAccess

请求的访问权限。这可以是 GENERIC_READ (0x80000000) 、 GENERIC_ALL (0x10000000) 或 MAXIMUM_ALLOWED (0x02000000) 的任意组合。如果此值为零 (0) ，可能会返回未定义的错误。使用 GENERIC_ALL 与调用 ResUtilEnumResourcesEx 相同。

返回值

如果操作成功，函数将返回 ERROR_SUCCESS。

如果操作失败，该函数将立即停止枚举并返回回调函数返回的值。

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2012
目标平台	Windows
标头	resapi.h
Library	ResUtils.lib
DLL	ResUtils.dll

另请参阅

资源实用工具函数

通过