PRESUTIL_GET_RESOURCE_NAME_DEPENDENCY

ローカルクラスター内の指定されたリソースの依存関係を列挙し、指定されたリソースの種類に該当する依存関係のハンドルを返します。PRESUTIL_GET_RESOURCE_NAME_DEPENDENCY 型は、この関数へのポインターを定義します。

操作が成功すると、 この関数は lpszResourceName で指定されたリソースが依存しているリソースのいずれかに対するハンドルを返します。呼び出し元は、CloseClusterResource を呼び出してハンドルを閉じる必要があります。

操作が失敗した場合、 この関数は NULL を返します。詳細については、GetLastError 関数を呼び出してください。

ResUtilGetResourceNameDependency、ResUtilGetResourceDependency、ResUtilGetResourceDependencyByName の各関数は、いずれも特定のリソースの種類の依存関係にアクセスする手段を提供する点でよく似ています。次の表に、これらの関数の違いをまとめます。

ResUtilGetResourceNameDependency は、リソース DLL のエントリポイント関数から呼び出さないでください。ResUtilGetResourceNameDependency はワーカースレッドから安全に呼び出せます。詳細については、リソース DLL で呼び出しを避けるべき関数を参照してください。

例

次の例に示すように、リソース A が Physical Disk リソースに依存していることが分かっている場合は、ResUtilGetResourceNameDependency を使用してその依存関係のハンドルを取得できます。

// 文字列の初期化とエラーチェックは省略しています。

HRESOURCE hResD = ResUtilGetResourceNameDependency(
                        L"Resource_A_Name",
                        L"Physical Disk" );

// ハンドルを閉じてメモリを解放します。