Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ResUtilGetResourceDependencyByClassEx function

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

Syntax


HRESOURCE WINAPI ResUtilGetResourceDependencyByClass(
  _In_ HCLUSTER                  hCluster,
  _In_ HANDLE                    hSelf,
  _In_ PCLUS_RESOURCE_CLASS_INFO prci,
  _In_ BOOL                      bRecurse,
  _In_ DWORD                     dwDesiredAccess
);

typedef HRESOURCE (WINAPI *PRESUTIL_GET_RESOURCE_DEPENDENCY_BY_CLASS_EX)(
    _In_ HCLUSTER                  hCluster,
    _In_ HANDLE                    hSelf,
    _In_ PCLUS_RESOURCE_CLASS_INFO prci,
    _In_ BOOL                      bRecurse,
    _In_ DWORD                     dwDesiredAccess
);

Parameters

hCluster [in]

A handle to the cluster to which the resource belongs.

hSelf [in]

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

prci [in]

A pointer to a PCLUS_RESOURCE_CLASS_INFO structure that describes the resource class of the dependency to return.

bRecurse [in]

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.

dwDesiredAccess [in]

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 ResUtilGetResourceDependencyByClass.

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.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2012

Header

ResApi.h

Library

ResUtils.lib

DLL

ResUtils.dll

See also

Resource Utility Functions

 

 

Show: