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 函数。
返回代码 | 说明 |
---|---|
|
|
|
操作未成功。 有关详细信息,请调用函数 GetLastError。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2012 |
目标平台 | Windows |
标头 | resapi.h |
Library | ResUtils.lib |
DLL | ResUtils.dll |