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 值。

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

备注

如果将 lpszName 参数指定为 NULL则 GetObjectName 方法返回 NOERROR

要求

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

另请参阅

IGetClusterDataInfo::GetObjectCount

IGetClusterObjectInfo