IGetClusterDataInfo::GetClusterName 方法 (cluadmex.h)

[此方法可用于“要求”部分中指定的操作系统。 Windows Server 2008 中删除了对此方法的支持。]

返回群集的名称。

语法

HRESULT GetClusterName(
  [out]     BSTR lpszName,
  [in, out] LONG *pcchName
);

参数

[out] lpszName

指向包含群集名称的以 null 结尾的 Unicode 字符串的指针;或 NULL ,表示调用方仅请求名称的长度。 尽管此参数声明为 BSTR,但实现为 LPWSTR

[in, out] pcchName

输入时,指向缓冲区大小的指针(以字符为单位),由 lpszName 参数指向。 输出时,指针指向缓冲区中的字符总数,包括 NULL 终止字符。

返回值

如果 GetClusterName 不成功,它可以返回其他 HRESULT 值。

返回代码/值 说明
NOERROR
0
操作成功。
E_INVALIDARG
0x80070057
一个或多个参数无效。
HRESULT_FROM_WIN32 (ERROR_MORE_DATA)
0x800700ea
lpszName 指向的缓冲区太小,无法保存请求的名称。 GetClusterName 返回 pcchName 内容中所需的字符数。

注解

如果 lpszName 参数设置为 NULL ,而 pcchName 参数未设置为 NULL则 GetClusterName 方法将返回 NOERROR

要求

要求
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2003 企业版、Windows Server 2003 Datacenter
目标平台 Windows
标头 cluadmex.h

另请参阅

IGetClusterDataInfo