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 值。
返回代码/值 | 说明 |
---|---|
|
操作成功。 |
|
一个或多个参数无效。 |
|
lpszName 指向的缓冲区太小,无法保存请求的名称。 GetClusterName 返回 pcchName 内容中所需的字符数。 |
注解
如果 lpszName 参数设置为 NULL ,而 pcchName 参数未设置为 NULL, 则 GetClusterName 方法将返回 NOERROR。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2003 企业版、Windows Server 2003 Datacenter |
目标平台 | Windows |
标头 | cluadmex.h |