ResUtilGetResourceDependency 関数 (resapi.h)

[アーティクル]
03/05/2024

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

構文

HRESOURCE ResUtilGetResourceDependency(
  [in] HANDLE  hSelf,
  [in] LPCWSTR lpszResourceType
);

パラメーター

[in] hSelf

依存リソースを処理します。このリソースは、1 つ以上のリソースに依存します。

[in] lpszResourceType

返される依存関係のリソースの種類を指定する Null で終わる Unicode 文字列。

戻り値

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

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

注釈

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

機能	依存リソースの指定方法	クラスターハンドルが必要です
ResUtilGetResourceDependency	リソースハンドル	いいえ
ResUtilGetResourceDependencyByName	リソースハンドル	Yes
ResUtilGetResourceNameDependency	リソース名	いいえ

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

例

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

// String initialization and error checking omitted.

HCLUSTER hCluster = OpenCluster( lpszClusterName );

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

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

// Close handles and free memory.

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
対象プラットフォーム	Windows
ヘッダー	resapi.h
Library	ResUtils.lib
[DLL]	ResUtils.dll