共用方式為


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

傳回碼/值 Description
NOERROR
0
作業成功。
E_INVALIDARG
0x80070057
一或多個參數無效。
HRESULT_FROM_WIN32 (ERROR_MORE_DATA)
0x800700ea
lpszName指向的緩衝區太小,無法保存要求的名稱。 GetObjectName 會傳回 pcchName內容中所需的字元數。

備註

如果 lpszName 參數指定為 NullGetObjectName 方法會傳回 NOERROR

規格需求

   
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2003 Enterprise、Windows Server 2003 Datacenter
目標平台 Windows
標頭 cluadmex.h

另請參閱

IGetClusterDataInfo::GetObjectCount

IGetClusterObjectInfo