ResUtilGetResourceNameDependency 関数 (resapi.h)
ローカル クラスター内の指定したリソースの依存関係を列挙し、指定したリソースの種類の依存関係へのハンドルを返します。 PRESUTIL_GET_RESOURCE_NAME_DEPENDENCY型は、この関数へのポインターを定義します。
構文
HRESOURCE ResUtilGetResourceNameDependency(
[in] LPCWSTR lpszResourceName,
[in] LPCWSTR lpszResourceType
);
パラメーター
[in] lpszResourceName
依存リソースの名前を指定する Null で終わる Unicode 文字列。 このリソースは、1 つ以上のリソースに依存します。
[in] lpszResourceType
返される依存関係のリソースの種類を指定する Null で終わる Unicode 文字列。
戻り値
操作が成功した場合、関数は lpszResourceName で指定されたリソースが依存するリソースのいずれかにハンドルを返します。 呼び出し元は、 CloseClusterResource を呼び出してハンドルを閉じる役割を担います。
操作が失敗した場合、関数は NULL を返します。 詳細については、 GetLastError 関数を呼び出します。
解説
ResUtilGetResourceNameDependency、ResUtilGetResourceDependency、ResUtilGetResourceDependencyByName 関数はすべて、特定のリソースの種類の依存関係へのアクセスを提供するという点で非常によく似ています。 次の表は、関数の違いをまとめたものです。
| 機能 | 依存リソースの指定方法 | クラスター ハンドルが必要です |
|---|---|---|
| ResUtilGetResourceDependency | リソース ハンドル | No |
| ResUtilGetResourceDependencyByName | リソース ハンドル | はい |
| ResUtilGetResourceNameDependency | リソース名 | No |
リソース DLL エントリ ポイント関数から ResUtilGetResourceNameDependency を呼び出さないでください。 ResUtilGetResourceNameDependency は、ワーカー スレッドから安全に呼び出すことができます。 詳細については、「 リソース DLL での回避する関数呼び出し」を参照してください。
例
次の例に示すように、リソース A が 物理ディスク リソースに依存していることがわかっている場合は、 ResUtilGetResourceNameDependency を使用して依存関係のハンドルを取得できます。
// String initialization and error checking omitted.
HRESOURCE hResD = ResUtilGetResourceNameDependency(
L"Resource_A_Name",
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 |
関連項目
ResUtilFindDependentDiskResourceDriveLetter
ResUtilGetResourceDependencyByClass