PRESUTIL_GET_RESOURCE_DEPENDENCY_BY_CLASS

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

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

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

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

例

次の例に示すように、リソース A が ストレージクラスのリソース に依存していることが分かっている場合は、ResUtilGetResourceDependencyByClass を使用して、そのリソースについて他に何も知らなくてもハンドルを取得できます。

// 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 );

PCLUS_RESOURCE_CLASS_INFO pClassInfo;

pClassInfo->rc = CLUS_RESCLASS_STORAGE;

//
// Returns a handle to the storage class resource on which resource A depends.
// Can now perform a variety of operations on the dependency.
//
HRESOURCE hResD = ResUtilGetResourceDependencyByClass(
                        hCluster,
                        hResA,
                        pClassInfo,
                        TRUE );

// Close handles and free memory.