AddClusterResourceDependency 関数 (clusapi.h)
2 つのリソース間に 依存関係 を作成 します。 PCLUSAPI_ADD_CLUSTER_RESOURCE_DEPENDENCY型は、この関数へのポインターを定義します。
構文
DWORD AddClusterResourceDependency(
[in] HRESOURCE hResource,
[in] HRESOURCE hDependsOn
);
パラメーター
[in] hResource
依存リソースへのハンドル。
[in] hDependsOn
hResource によって識別されるリソースが依存するリソースを処理します。
戻り値
操作が成功すると、 ERROR_SUCCESS (0) が返されます。
操作が失敗した場合、 AddClusterResourceDependency は システム エラー コードの 1 つを返します。 可能な戻り値を次に示します。
| リターン コード/値 | Description |
|---|---|
|
リソースはそれ自体に依存します。 |
|
リソースの依存関係は既に存在します。 |
|
依存リソースはクォーラムです。 |
|
リソースが同じグループに含まれていません。 |
|
少なくとも 1 つのリソースが削除対象としてマークされています。 |
|
依存リソースは既にオンラインです。 |
注釈
AddClusterResourceDependency 関数によって作成された依存関係は、障害が発生した後に 1 つのノードから別のノードにリソースを移動する方法に影響します。 リソースがオフラインになり、オンラインに戻される順序が決まります。
依存関係のリソースは、一緒に移動する必要があります。 依存リソースは、依存するリソースの後にオンラインにする必要があります。
hResource と hDependsOn によって識別される 2 つのリソースは、同じグループ内に存在する必要があります。
hResource が既にオンラインの場合は、AddClusterResourceDependency を呼び出さないでください。 呼び出しは 、ERROR_RESOURCE_ONLINE エラーで失敗します。 この動作は Windows Server 2008 で変更されていることに注意してください。 AddClusterResourceDependency を呼び出し、リソースをオフラインにすることなくリソースの依存関係を変更できます。
リソース DLL から AddClusterResourceDependency を呼び出さないでください。 詳細については、「 リソース DLL での回避する関数呼び出し」を参照してください。
LPC ハンドルと RPC ハンドルを同じ関数呼び出しに渡さないでください。 それ以外の場合、呼び出しは RPC 例外を発生させ、追加の破壊的影響を及ぼす可能性があります。 LPC ハンドルと RPC ハンドルの作成方法については、「 オブジェクト ハンドル と OpenCluster の使用」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | clusapi.h |
| Library | ClusAPI.lib |
| [DLL] | ClusAPI.dll |