ResUtilGetResourceNameDependency 函数 (resapi.h)

枚举本地群集中指定资源的依赖项,并返回指定资源类型的依赖项的句柄。 PRESUTIL_GET_RESOURCE_NAME_DEPENDENCY类型定义指向此函数的指针。

语法

HRESOURCE ResUtilGetResourceNameDependency(
  [in] LPCWSTR lpszResourceName,
  [in] LPCWSTR lpszResourceType
);

parameters

[in] lpszResourceName

以 Null 结尾的 Unicode 字符串,用于指定依赖资源的名称。 此资源依赖于一个或多个资源。

[in] lpszResourceType

以 Null 结尾的 Unicode 字符串,指定要返回的依赖项的资源类型。

返回值

如果操作成功,函数将返回一个句柄,该句柄指向 lpszResourceName 指定的资源所依赖的资源之一。 调用方负责通过调用 CloseClusterResource 关闭句柄。

如果操作失败,函数将返回 NULL。 有关详细信息,请调用函数 GetLastError

注解

ResUtilGetResourceNameDependencyResUtilGetResourceDependencyResUtilGetResourceDependencyByName 函数非常相似,因为它们都提供对特定资源类型的依赖项的访问权限。 下表汇总了函数之间的差异。

函数 如何指定依赖资源 需要群集句柄
ResUtilGetResourceDependency 资源句柄
ResUtilGetResourceDependencyByName 资源句柄
ResUtilGetResourceNameDependency 资源名称
 

不要从任何资源 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 企业版、Windows Server 2008 Datacenter
目标平台 Windows
标头 resapi.h
Library ResUtils.lib
DLL ResUtils.dll

请参阅

CloseClusterResource

ResUtilFindDependentDiskResourceDriveLetter

ResUtilGetResourceDependency

ResUtilGetResourceDependencyByClass

ResUtilGetResourceDependencyByName

ResUtilGetResourceDependentIPAddressProps