ResUtilGetResourceDependencyByNameEx 函数 (resapi.h)

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

语法

HRESOURCE ResUtilGetResourceDependencyByNameEx(
  [in] HCLUSTER hCluster,
  [in] HANDLE   hSelf,
  [in] LPCWSTR  lpszResourceType,
  [in] BOOL     bRecurse,
  [in] DWORD    dwDesiredAccess
);

参数

[in] hCluster

资源所属群集的句柄。

[in] hSelf

依赖资源的句柄。 此资源依赖于一个或多个资源。

[in] lpszResourceType

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

[in] bRecurse

确定搜索的范围。 如果 为 TRUE,则函数将检查依赖资源下的整个依赖项树。 如果 为 FALSE,则函数仅检查依赖资源直接依赖的资源。

[in] dwDesiredAccess

请求的访问权限。 这可能是 GENERIC_READ (0x80000000) GENERIC_ALL (0x10000000) MAXIMUM_ALLOWED (0x02000000) 的任意组合。 如果此值为零 (0) ,则可能返回未定义的错误。 使用 GENERIC_ALL 与调用 ResUtilGetResourceDependencyByName 相同。

返回值

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

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

返回代码 说明
HRESOURCE
NULL
操作未成功。 有关详细信息,请调用函数 GetLastError

要求

要求
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2012
目标平台 Windows
标头 resapi.h
Library ResUtils.lib
DLL ResUtils.dll

另请参阅

资源实用工具函数