GetClusterQuorumResource 函数 (clusapi.h)

返回群集仲裁 资源的名称。 PCLUSAPI_GET_CLUSTER_QUORUM_RESOURCE类型定义指向此函数的指针。

语法

DWORD GetClusterQuorumResource(
  [in]      HCLUSTER hCluster,
  [out]     LPWSTR   lpszResourceName,
  [in, out] LPDWORD  lpcchResourceName,
  [out]     LPWSTR   lpszDeviceName,
  [in, out] LPDWORD  lpcchDeviceName,
  [out]     LPDWORD  lpdwMaxQuorumLogSize
);

参数

[in] hCluster

现有 群集的句柄。

[out] lpszResourceName

指向以 null 结尾的 Unicode 字符串的指针,该字符串包含群集仲裁资源的名称。 该名称是从仲裁资源的 Name 公共属性中读取的。 不要为此参数传递 NULL

[in, out] lpcchResourceName

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

[out] lpszDeviceName

指向以 null 结尾的 Unicode 字符串的指针,该字符串包含 群集服务维护的仲裁日志文件位置的路径。 不要为此参数传递 NULL

[in, out] lpcchDeviceName

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

[out] lpdwMaxQuorumLogSize

指向仲裁资源维护的日志) 最大大小 (的指针(以字节为单位)。 不要为此参数传递 NULL

返回值

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

如果操作失败,函数将返回 系统错误代码。 下面是可能的值之一。

返回代码 说明
ERROR_MORE_DATA
lpszResourceNamelpszDeviceName 缓冲区不够大,无法保存结果。 lpcchResourceNamelpcchDeviceName 参数返回结果中的字符数,不包括终止 NULL

注解

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

要求

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

另请参阅

名称

SetClusterQuorumResource