getClusterGroupState 函式 (clusapi.h)
傳回 群組的目前狀態。 PCLUSAPI_GET_CLUSTER_GROUP_STATE類型會定義此函式的指標。
語法
CLUSTER_GROUP_STATE GetClusterGroupState(
[in] HGROUP hGroup,
[out, optional] LPWSTR lpszNodeName,
[in, out, optional] LPDWORD lpcchNodeName
);
參數
[in] hGroup
應傳回狀態資訊的群組句柄。
[out, optional] lpszNodeName
Null 終止 Unicode 字串的指標，其中包含目前擁有群組之節點的名稱。
[in, out, optional] lpcchNodeName
以字元計數表示 之 lpszNodeName 緩衝區大小的指標。 在輸入時，指定緩衝區可保留的最大字元數，包括終止 NULL。 在輸出中，指定結果名稱中的字元數，不包括終止 NULL。
傳回值
GetClusterGroupState 會傳回群組的目前狀態，由下列其中一個值表示。
| 傳回碼/值 | Description |
|---|---|
|
作業未成功。 如需錯誤的詳細資訊，請呼叫 函式 GetLastError。 |
|
群組中的所有資源都在 在線。 |
|
群組中的所有資源都 脫機 ，或群組中沒有資源。 |
|
群組中至少有一個資源失敗， (從 CLUSTER_RESOURCE_STATE 列舉) 設定 ClusterResourceFailed 的狀態。 |
|
群組中至少一個資源上線。 沒有擱 置 或 失敗的資源。 |
|
群組中至少一個資源處於擱置狀態。 沒有資源失敗。 |
備註
請注意， lpcchName 是指字元計數，而不是位元組計數，而且傳回的大小不包含計數中的終止 NULL 。 如需重設大小緩衝區的詳細資訊，請參閱 數據大小慣例。
請勿從任何資源 DLL 進入點函式呼叫 GetClusterGroupState 。 可以從背景工作線程安全地呼叫 GetClusterGroupState。 如需詳細資訊，請參閱 在資源 DLL 中避免的函數調用。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 目標平台 | Windows |
| 標頭 | clusapi.h |
| 程式庫 | ClusAPI.lib |
| Dll | ClusAPI.dll |