Edit

ResUtilGetResourceDependencyByNameEx function (resapi.h)

  • Article

Enumerates the dependencies of a specified resource in a specified cluster and returns a handle to a dependency of a specified type. The PRESUTIL_GET_RESOURCE_DEPENDENCY_BY_NAME_EX type defines a pointer to this function.

Syntax

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

Parameters

[in] hCluster

A handle to the cluster to which the resource belongs.

[in] hSelf

A handle to the dependent resource. This resource depends on one or more resources.

[in] lpszResourceType

A null-terminated Unicode string that specifies the resource type of the dependency to return.

[in] bRecurse

Determines the scope of the search. If TRUE, the function checks the entire dependency tree under the dependent resource. If FALSE, the function checks only the resources on which the dependent resource directly depends.

[in] dwDesiredAccess

The requested access privileges. This might be any combination of GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000), or MAXIMUM_ALLOWED (0x02000000). If this value is zero (0), an undefined error might be returned. Using GENERIC_ALL is the same as calling ResUtilGetResourceDependencyByName.

Return value

If the operation succeeds, the function returns a handle to one of the resources on which the resource that is specified by hSelf depends. The caller is responsible for closing the handle by calling CloseClusterResource.

If the operation fails, the function returns NULL. For more information, call the GetLastError function.

Return code Description
HRESOURCE
NULL
 The operation was not successful. For more information, call the function GetLastError.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2012
Target Platform Windows
Header resapi.h
Library ResUtils.lib
DLL ResUtils.dll

See also

Resource Utility Functions