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 列挙値によって記述されます。

クラスターサービスがノードにインストールされていません。

クラスターサービスはノードにインストールされますが、まだ構成されていません。

クラスターサービスはノードにインストールされ、構成されていますが、現在は実行されていません。

クラスターサービスは、ノードにインストール、構成、および実行されます。

操作が成功すると、関数は 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