CLUSCTL_RESOURCE_TYPE_GET_CLASS_INFO

The CLUSCTL_RESOURCE_TYPE_GET_CLASS_INFO control code is used to request the class and subclass of a resource type. A resource class identifies resources of similar capability.

Quick Info

Type: External
Access: CLUS_ACCESS_READ
Input: None
Output: CLUS_RESOURCE_CLASS_INFO structure
Global: CLUS_NOT_GLOBAL
Modify: CLUS_NO_MODIFY
Code: CLCTL_GET_CLASS_INFO

Notes to Callers

When you call ClusterResourceTypeControl with the CLUSCTL_RESOURCE_TYPE_GET_CLASS_INFO, it returns a CLUS_RESOURCE_CLASS_INFO structure that describes the class and subclass of the resource type. The subclass is a value that is specific to the class and provides more description, such as CLUS_RESSUBCLASS_SHARED. This subclass is valid for storage class resources such as Physical Disk resources and indicates that the resource is accessible to more than one node in the cluster.

Cluster Service will not recognize a user-defined resource class, as indicated by the rc member of the CLUS_RESOURCE_CLASS_INFO being set to a value greater than CLUS_RESCLASS_USER. CLUS_RESCLASS_USER marks the beginning of the user-defined range for resource classes. However, custom resource classes can be recognized and used by cluster-aware applications and resource DLLs.

Notes to Resource DLL Writers

If you define your own resource class, you should provide a unique identifier for the class that is set to a value greater than CLUS_RESCLASS_USER. CLUS_RESCLASS_USER specifies the beginning for user-defined resource class identifiers. To obtain a resource class identifier from Microsoft that is guaranteed to be unique, send mail to resclass@microsoft.com with the following information:

If you do not support the CLUSCTL_RESOURCE_TYPE_GET_CLASS_INFO control code, return ERROR_INVALID_FUNCTION. The Resource Monitor provides default handling of this control code.