PRESUTIL_GET_RESOURCE_DEPENDENCY_BY_NAME

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

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

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

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

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

例

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

// String initialization and error checking omitted.

HCLUSTER hCluster = OpenCluster( lpszClusterName );

//
// Resource A depends on a storage class resource.
// Get a handle to that resource.
//
HRESOURCE hResA = OpenClusterResource( hCluster, lpszResName );

HRESOURCE hResD = ResUtilGetResourceDependencyByName(
                        hCluster,
                        hResA,
                        L"Physical Disk",
                        TRUE );

// Close handles and free memory.