ResUtilGetCoreClusterResourcesEx function (resapi.h)

Returns handles to the core, Network Name, IP Address, and quorum resources. The PRESUTIL_GET_CORE_CLUSTER_RESOURCES_EX type defines a pointer to this function.

Syntax

DWORD ResUtilGetCoreClusterResourcesEx(
 [in] HCLUSTER hClusterIn,
 [out] HRESOURCE *phClusterNameResourceOut,
 [out] HRESOURCE *phClusterQuorumResourceOut,
 [in] DWORD dwDesiredAccess
);

Parameters

[in] hClusterIn

The cluster handle (see OpenCluster).

[out] phClusterNameResourceOut

A pointer to a resource handle to the core Network Name resource for the cluster, which stores the cluster name.

[out] phClusterQuorumResourceOut

Not used.

[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 ResUtilGetCoreClusterResources.

Return value

If the operations succeeds, the function returns ERROR_SUCCESS.

If the operation fails, the function returns a system error code.

Requirements

See also

Resource Utility Functions