PRESUTIL_GET_RESOURCE_DEPENDENCY

指定した リソース の 依存関係 を列挙し、指定した種類の依存関係のハンドルを返します。PRESUTIL_GET_RESOURCE_DEPENDENCY 型は、この関数へのポインターを定義します。

操作が成功した場合、 この関数は hSelf で指定されたリソースが依存しているリソースのいずれか 1 つのハンドルを返します。呼び出し元は、CloseClusterResource を呼び出してハンドルを閉じる責任があります。

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

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

リソース DLL のエントリポイント関数からは、ResUtilGetResourceDependency を呼び出さないでください。ResUtilGetResourceDependency はワーカースレッドからであれば安全に呼び出せます。詳細については、Function Calls to Avoid in Resource DLLs を参照してください。

例

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

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

HCLUSTER hCluster = OpenCluster( lpszClusterName );

//
// リソース A は物理ディスク リソースに依存しています。
// そのリソースのハンドルを取得します。
//
HRESOURCE hResA = OpenClusterResource( hCluster, lpszResName );

HRESOURCE hResD = ResUtilGetResourceDependency(
                        hResA,
                        L"Physical Disk" );

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