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 |
---|---|
|
作業成功。 |
|
一或多個參數無效。 |
|
lpszName指向的緩衝區太小,無法保存要求的名稱。 GetObjectName 會傳回 pcchName內容中所需的字元數。 |
備註
如果 lpszName 參數指定為 Null, GetObjectName 方法會傳回 NOERROR。
規格需求
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2003 Enterprise、Windows Server 2003 Datacenter |
目標平台 | Windows |
標頭 | cluadmex.h |