IGetClusterObjectInfo::GetObjectName 方法 (cluadmex.h)
[此方法可用于“要求”部分中指定的操作系统。 Windows Server 2008 中已删除对此方法的支持。]
返回 群集对象的名称。
语法
HRESULT GetObjectName(
[in] LONG lObjIndex,
[out] BSTR lpszName,
[in, out] LONG *pcchName
);
参数
[in] lObjIndex
一个数字,表示目标对象的从零开始的索引。 lObjIndex 限制为可通过调用 IGetClusterDataInfo::GetObjectCount 检索的数字。
[out] lpszName
指向以 null 结尾的 Unicode 字符串的指针,该字符串包含与 lObjIndex 关联的对象的名称。 lpszName 参数可以为 NULL,表示调用方仅请求名称长度。 虽然声明为 BSTR,但此参数实现为 LPWSTR。
[in, out] pcchName
输入时,指向 lpszName 参数指向的缓冲区中的字符计数的指针。 pcchName 参数不能为 NULL。 在输出中,指向 存储在 lpszName 内容中的名称中的字符计数的指针,包括 NULL 终止字符。
返回值
如果 GetObjectName 不成功,它可以返回其他 HRESULT 值。
返回代码/值 | 说明 |
---|---|
|
操作成功。 |
|
一个或多个参数无效。 |
|
lpszName 指向的缓冲区太小,无法容纳请求的名称。 GetObjectName 返回 pcchName 内容中所需的字符数。 |
备注
如果将 lpszName 参数指定为 NULL, 则 GetObjectName 方法返回 NOERROR。
要求
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2003 企业版、Windows Server 2003 Datacenter |
目标平台 | Windows |
标头 | cluadmex.h |