CLUS_CHARACTERISTICS enumeration (clusapi.h)

  • Article

Enumerates characteristics of resource types and resources.

Syntax

typedef enum CLUS_CHARACTERISTICS {
  CLUS_CHAR_UNKNOWN = 0x00000000,
  CLUS_CHAR_QUORUM = 0x00000001,
  CLUS_CHAR_DELETE_REQUIRES_ALL_NODES = 0x00000002,
  CLUS_CHAR_LOCAL_QUORUM = 0x00000004,
  CLUS_CHAR_LOCAL_QUORUM_DEBUG = 0x00000008,
  CLUS_CHAR_REQUIRES_STATE_CHANGE_REASON = 0x00000010,
  CLUS_CHAR_BROADCAST_DELETE = 0x00000020,
  CLUS_CHAR_SINGLE_CLUSTER_INSTANCE = 0x00000040,
  CLUS_CHAR_SINGLE_GROUP_INSTANCE = 0x00000080,
  CLUS_CHAR_COEXIST_IN_SHARED_VOLUME_GROUP = 0x00000100,
  CLUS_CHAR_PLACEMENT_DATA = 0x00000200,
  CLUS_CHAR_MONITOR_DETACH = 0x00000400,
  CLUS_CHAR_MONITOR_REATTACH = 0x00000800,
  CLUS_CHAR_OPERATION_CONTEXT = 0x00001000,
  CLUS_CHAR_CLONES = 0x00002000,
  CLUS_CHAR_NOT_PREEMPTABLE = 0x00004000,
  CLUS_CHAR_NOTIFY_NEW_OWNER = 0x00008000,
  CLUS_CHAR_SUPPORTS_UNMONITORED_STATE = 0x00010000,
  CLUS_CHAR_INFRASTRUCTURE = 0x00020000,
  CLUS_CHAR_VETO_DRAIN,
  CLUS_CHAR_DRAIN_LOCAL_OFFLINE
} ;

Constants

 
CLUS_CHAR_UNKNOWN
Value: 0x00000000
Resources of this type have no known characteristics.
CLUS_CHAR_QUORUM
Value: 0x00000001
Resources of this type are capable of being the
quorum resource type for a cluster.
CLUS_CHAR_DELETE_REQUIRES_ALL_NODES
Value: 0x00000002
Resources of this type cannot be deleted unless all nodes are active.
CLUS_CHAR_LOCAL_QUORUM
Value: 0x00000004
Not supported.
CLUS_CHAR_LOCAL_QUORUM_DEBUG
Value: 0x00000008
Not supported.
CLUS_CHAR_REQUIRES_STATE_CHANGE_REASON
Value: 0x00000010
The resource DLL will receive the
CLUSCTL_RESOURCE_STATE_CHANGE_REASON
control code.
CLUS_CHAR_BROADCAST_DELETE
Value: 0x00000020
Not supported.
CLUS_CHAR_SINGLE_CLUSTER_INSTANCE
Value: 0x00000040
Only one instance of this resource type is allowed in a cluster.
CLUS_CHAR_SINGLE_GROUP_INSTANCE
Value: 0x00000080
Only one instance of this resource type is allowed in a group.
CLUS_CHAR_COEXIST_IN_SHARED_VOLUME_GROUP
Value: 0x00000100
The resource can be made part of a special group. Protocol version 2.0 servers do not support this value.
CLUS_CHAR_PLACEMENT_DATA
Value: 0x00000200
The resource type can be queried to get more information about how many resources it uses. For example, in the virtual machine resource type, information is returned about how much memory is required for the virtual machine to be started.

Windows Server 2008 R2 and Windows Server 2008:  This enumeration value is not supported before Windows Server 2012.
CLUS_CHAR_MONITOR_DETACH
Value: 0x00000400
The resource can be deleted without being taken offline. Protocol version 2.0 servers do not support this value.
CLUS_CHAR_MONITOR_REATTACH
Value: 0x00000800
This value is reserved for local use and must be ignored by the client. Protocol version 2.0 servers do not support this value.
CLUS_CHAR_OPERATION_CONTEXT
Value: 0x00001000
This value is reserved for local use and must be ignored by the client. Protocol version 2.0 servers do not support this value.
CLUS_CHAR_CLONES
Value: 0x00002000
This value is reserved for local use and must be ignored by the client. Protocol version 2.0 servers do not support this value.
CLUS_CHAR_NOT_PREEMPTABLE
Value: 0x00004000
The resource should not be preempted, even if the whole group is being preempted.

Windows Server 2008 R2 and Windows Server 2008:  This enumeration value is not supported before Windows Server 2012.
CLUS_CHAR_NOTIFY_NEW_OWNER
Value: 0x00008000
The resource can receive a new owner.

Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  This enumeration value is not supported before Windows Server 2012 R2.
CLUS_CHAR_SUPPORTS_UNMONITORED_STATE
Value: 0x00010000
The resource can continue run in an unmonitored state when it losses cluster membership.

Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  This enumeration value is not supported before Windows Server 2016.
CLUS_CHAR_INFRASTRUCTURE
Value: 0x00020000
This value is reserved for infrastructure.

Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  This enumeration value is not supported before Windows Server 2016.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2008 Datacenter, Windows Server 2008 Enterprise
Header clusapi.h

See also

CLUSCTL_GROUP_GET_CHARACTERISTICS

CLUSCTL_NETINTERFACE_GET_CHARACTERISTICS

CLUSCTL_NETWORK_GET_CHARACTERISTICS

CLUSCTL_NODE_GET_CHARACTERISTICS

CLUSCTL_RESOURCE_GET_CHARACTERISTICS

CLUSCTL_RESOURCE_TYPE_GET_CHARACTERISTICS

Failover Cluster Enumerations