CreateCluster 関数 (clusapi.h)
クラスターを作成して起動します。 クラスターは、指定されたノードのセットで構成され、 ネットワーク名、 IP アドレス、 クォーラム リソース (指定されている場合) が含まれます。 PCLUSAPI_CREATE_CLUSTER型は、この関数へのポインターを定義します。
構文
HCLUSTER CreateCluster(
[in] PCREATE_CLUSTER_CONFIG pConfig,
[in, optional] PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
[in, optional] PVOID pvCallbackArg
);
パラメーター
[in] pConfig
作成するクラスターに関する構成情報を含む CREATE_CLUSTER_CONFIG 構造体のアドレス。
[in, optional] pfnProgressCallback
クラスターの作成の進行状況を提供するために定期的に呼び出される PCLUSTER_SETUP_PROGRESS_CALLBACK 関数ポインターに一致するコールバック関数のアドレス。
[in, optional] pvCallbackArg
コールバック関数の引数。
戻り値
新しく作成されたクラスターまたは NULL を処理します。 NULL 以外の値は、完全な成功を示すわけではありません (すべてのノードが追加されますが、すべての IP アドレスまたはネットワーク名リソースが作成されたわけではありません)。 pfnProgressCallback パラメーターが指す関数に渡されるパラメーターを確認する必要があります。
| リターン コード | 説明 |
|---|---|
|
大部分のノードが正常に作成されました。 エラーの詳細については、 GetLastError 関数を呼び出します。 |
注釈
PCLUSAPI_CREATE_CLUSTER型は、この関数へのポインターを定義し、GetProcAddress 関数と共に使用してこの関数を呼び出すことができます。
CreateCluster 関数が正常に完了したら、AddClusterNode 関数を呼び出してノードを追加する前に、少なくとも 30 秒を許可する必要があります。
クラスター クォーラムが達成された後、 CreateCluster 関数は正常に完了します。 1 つ以上のクラスター ノードが 、数秒間 ClusterNodeDown または ClusterNodeJoining 状態である可能性があります。
CreateCluster 関数を呼び出す前に、次のコードに示すように、dwCoInit パラメーターのCOINIT_MULTITHREADEDとCOINIT_DISABLE_OLE1DDEの両方を指定して CoInitializeEx 関数を呼び出す必要があります。
CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Datacenter、Windows Server 2008 Enterprise |
| 対象プラットフォーム | Windows |
| ヘッダー | clusapi.h |
| Library | ClusAPI.lib |
| [DLL] | ClusAPI.dll |