ResUtilResourcesEqual function (resapi.h)

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

See also

CLUSCTL_RESOURCE_GET_NAME

ClusterResourceControl