IGetClusterResourceInfo::GetResourceNetworkName 方法 (cluadmex.h)
[這個方法可用於需求一節中指定的操作系統。 Windows Server 2008 已移除此方法的支援。]
語法
BOOL GetResourceNetworkName(
[in] LONG lObjIndex,
[out] BSTR lpszNetName,
[in, out] ULONG *pcchNetName
);
參數
[in] lObjIndex
數位,表示目標資源的以零起始的索引。 目標資源不一定相依於網路名稱資源。 lObjIndex 限制為可藉由呼叫 IGetClusterDataInfo::GetObjectCount 來擷取的數位。
[out] lpszNetName
以 Null 結尾的 Unicode 字串指標,其中包含 由 lObjIndex 編製索引之資源所相依的網路名稱。 雖然宣告為 BSTR,但此參數會實作為 LPWSTR。
[in, out] pcchNetName
以 lpszNetName 所指向緩衝區字元為單位的最大計數指標。 在輸入時,此值應該夠大,足以包含 MAX_COMPUTERNAME_LENGTH + 1 個字元。 輸出時, pcchNetName 會指向複製到 lpszNetName 內容的實際字元數。
傳回值
傳回碼/值 | Description |
---|---|
|
由 lObjIndex 編製索引的資源相依於網路名稱資源,且已成功傳回網路的名稱。 |
|
由 lObjIndex 編製索引的資源不相依於網路名稱資源。 |
備註
需要 GetResourceNetworkName 方法,才能允許故障轉移叢集管理員擴充屬性頁判斷資源是否具有現有或擱置中的網路名稱資源相依性。
網路的名稱會儲存在網路名稱資源的 Name 私人屬性中。 網路名稱資源的 Name 通用屬性是資源的名稱,而不是網路。
MAX_COMPUTERNAME_LENGTH 是 Windows 頭檔 WinBase.h 中定義為 15 的常數。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2003 Enterprise、Windows Server 2003 Datacenter |
目標平台 | Windows |
標頭 | cluadmex.h |