CLUSCTL_RESOURCE_GET

CLUSCTL_RESOURCE_GET_FLAGS

The CLUSCTL_RESOURCE_GET_FLAGS control code is used to request the flags that are set for a resource.

Quick Info

Type:	External
Access:	CLUS_ACCESS_READ
Input:	None
Output:	DWORD bitmask
Global:	CLUS_NOT_GLOBAL
Modify:	CLUS_NO_MODIFY
Code:	CLCTL_GET_FLAGS

Notes to Callers

ClusterResourceControl returns a bitmask that describes the extrinsic attributes of the resource. The following flag is defined by the Cluster Service as valid:

CLUS_FLAG_CORE

When CLUS_FLAG_CORE is set, this indicates that the resource is essential to the cluster and cannot be deleted. Included in this group of essential resources are:

IP Address resource of the cluster
Network Name resource of the cluster
Quorum resource

Because only the lower 16 bits of the bitmask are reserved for Microsoft internal use, flags defined by third-party developers can also be returned.

Notes to Resource DLL Writers

Resource DLLs can define their own resource-specific flags in the upper 16 bits of the bitmask returned with CLUSCTL_RESOURCE_GET_FLAGS. The lower 16 bits of the bitmask are reserved for Microsoft internal use. If your resource DLL needs to define flags, handle the CLUSCTL_RESOURCE_GET_FLAGS control code in your ResourceControl entry point function. Otherwise, return ERROR_INVALID_FUNCTION to let the Resource Monitor handle it. The Resource Monitor will read the Flags value from the resource's key in the cluster database.