ResUtilResourcesEqual function (resapi.h)

Article
10/13/2021

Tests whether two resource handles represent the same resource. The PRESUTIL_RESOURCES_EQUAL type defines a pointer to this function.

Syntax

BOOL ResUtilResourcesEqual(
  [in] HRESOURCE hSelf,
  [in] HRESOURCE hResource
);

Parameters

[in] hSelf

Handle to one of the resources.

[in] hResource

Handle to the other resource.

Return value

If the resources are equal, the function returns TRUE.

If the resources are not equal, the function returns FALSE.

Remarks

The ResUtilResourcesEqual utility function compares the two resources by retrieving their names. To retrieve the names, ResUtilResourcesEqual passes the CLUSCTL_RESOURCE_GET_NAME control code to the ClusterResourceControl function. If the names are the same, the resources are equal.

Do not pass LPC and RPC handles in the same function call. If you do, the call will raise an RPC exception and can result in additional destructive effects. For information on how LPC and RPC handles are created, see Using Object Handles and OpenCluster.

Requirements

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