ResUtilEnumResourcesEx 函数 (resapi.h)

项目
08/25/2023

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

语法

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

参数

[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

传递给 ResUtilEnumResourcesEx 的hCluster 参数。

hSelf

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

hEnum

当前正在枚举的资源的句柄。 ResUtilEnumResourcesEx 会自动打开并关闭此句柄。

pParameter

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

[in] pParameter

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

返回值

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

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

注解

ResUtilEnumResourcesEx 是 ClusterResourceEnum 函数的一种方便且易于使用的替代方法。

示例

请参阅 ResUtilEnumResources 的示例。

要求

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

另请参阅

ClusterResourceEnum

ResUtilEnumResources

ResourceCallbackEx

通过