ClusterResourceTypeEnum 函数 (clusapi.h)

项目
08/22/2023

枚举资源类型的可能所有者节点或资源，并返回每个调用的一个节点或资源的名称。 PCLUSAPI_CLUSTER_RESOURCE_TYPE_ENUM类型定义指向此函数的指针。

语法

DWORD ClusterResourceTypeEnum(
  [in]      HRESTYPEENUM hResTypeEnum,
  [in]      DWORD        dwIndex,
  [out]     LPDWORD      lpdwType,
  [out]     LPWSTR       lpszName,
  [in, out] LPDWORD      lpcchName
);

参数

[in] hResTypeEnum

从 ClusterResourceTypeOpenEnum 返回的资源类型枚举句柄。

[in] dwIndex

要返回的资源或节点对象的索引。首次调用 ClusterResourceTypeEnum 时，此参数应为零，然后对后续调用递增。

[out] lpdwType

ClusterResourceTypeEnum 返回的对象类型。 CLUSTER_RESOURCE_TYPE_ENUM枚举的以下值有效。

CLUSTER_RESOURCE_TYPE_ENUM_NODES (1)

对象是一个节点，可以是资源类型的可能所有者。

CLUSTER_RESOURCE_TYPE_ENUM_RESOURCES (2)

对象是作为资源类型的实例的资源。

[out] lpszName

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含返回的对象的名称。

[in, out] lpcchName

指向 lpszName 缓冲区大小（以字符计数表示）的指针。输入时，指定缓冲区可以容纳的最大字符数，包括终止 NULL。在输出时，指定结果名称中的字符数，不包括终止 NULL。

返回值

函数返回以下值之一。

返回代码/值	说明
ERROR_SUCCESS 0	操作成功。
ERROR_NO_MORE_ITEMS 259	没有更多要返回的对象。
ERROR_MORE_DATA 234	lpszName 指向的缓冲区不够大，无法保存结果。 lpcchName 参数返回结果中的字符数，不包括终止 NULL。
系统错误代码	此操作失败。

注解

请注意， lpcchName 指的是字符计数，而不是字节计数，并且返回的大小不包括计数中的终止 NULL 。有关调整缓冲区大小的详细信息，请参阅数据大小约定。

示例

请参阅枚举对象。

要求

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