GetNodeClusterState 函式 (clusapi.h)
判斷是否已在節點上安裝和執行叢集服務。 PCLUSAPI_GET_NODE_CLUSTER_STATE類型會定義此函式的指標。
語法
DWORD GetNodeClusterState(
[in, optional] LPCWSTR lpszNodeName,
[out] LPDWORD pdwClusterState
);
參數
[in, optional] lpszNodeName
Null 終止的 Unicode 字串指標,其中包含要查詢之節點的名稱。 如果 lpszNodeName 為 NULL,則會查詢本機節點。
[out] pdwClusterState
值指標,描述節點上叢集服務的狀態。 節點將由下列其中一個 NODE_CLUSTER_STATE 列舉值來描述。
ClusterStateNotInstalled (0)
叢集服務未安裝在節點上。
ClusterStateNotConfigured (1)
叢集服務已安裝在節點上,但尚未設定。
ClusterStateNotRunning (3)
叢集服務會在節點上安裝並設定,但目前未執行。
ClusterStateRunning (19 (0x13) )
叢集服務會在節點上安裝、設定和執行。
傳回值
如果作業成功,函式會傳回 ERROR_SUCCESS ( 0) 。 如果作業失敗,函式會傳回 系統錯誤碼。
備註
注意 如果呼叫的應用程式是以 32 位 Windows 為基礎, GetNodeClusterState 函式不支援以 64 位 Windows 為基礎的 節點 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
目標平台 | Windows |
標頭 | clusapi.h |
程式庫 | ClusAPI.lib |
Dll | ClusAPI.dll |