クラスター サービスがノードにインストールされ、実行されているかどうかを判断します。 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) を返します。 操作が失敗した場合、関数は システム エラー コードを返します。
注釈
メモGetNodeClusterState 関数は、呼び出し元のアプリケーションが 32 ビットの Windows ベースの場合、64 ビットの Windows ベースのノードをサポートしません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | clusapi.h |
| Library | ClusAPI.lib |
| [DLL] | ClusAPI.dll |