CLUSTER_CHANGE enumeration (clusapi.h)

  • Article

Describes the type of notification returned. The GetClusterNotify, RegisterClusterNotify, and CreateCluster functions use this enumeration.

Syntax

typedef enum CLUSTER_CHANGE {
  CLUSTER_CHANGE_NODE_STATE = 0x00000001,
  CLUSTER_CHANGE_NODE_DELETED = 0x00000002,
  CLUSTER_CHANGE_NODE_ADDED = 0x00000004,
  CLUSTER_CHANGE_NODE_PROPERTY = 0x00000008,
  CLUSTER_CHANGE_REGISTRY_NAME = 0x00000010,
  CLUSTER_CHANGE_REGISTRY_ATTRIBUTES = 0x00000020,
  CLUSTER_CHANGE_REGISTRY_VALUE = 0x00000040,
  CLUSTER_CHANGE_REGISTRY_SUBTREE = 0x00000080,
  CLUSTER_CHANGE_RESOURCE_STATE = 0x00000100,
  CLUSTER_CHANGE_RESOURCE_DELETED = 0x00000200,
  CLUSTER_CHANGE_RESOURCE_ADDED = 0x00000400,
  CLUSTER_CHANGE_RESOURCE_PROPERTY = 0x00000800,
  CLUSTER_CHANGE_GROUP_STATE = 0x00001000,
  CLUSTER_CHANGE_GROUP_DELETED = 0x00002000,
  CLUSTER_CHANGE_GROUP_ADDED = 0x00004000,
  CLUSTER_CHANGE_GROUP_PROPERTY = 0x00008000,
  CLUSTER_CHANGE_RESOURCE_TYPE_DELETED = 0x00010000,
  CLUSTER_CHANGE_RESOURCE_TYPE_ADDED = 0x00020000,
  CLUSTER_CHANGE_RESOURCE_TYPE_PROPERTY = 0x00040000,
  CLUSTER_CHANGE_CLUSTER_RECONNECT = 0x00080000,
  CLUSTER_CHANGE_NETWORK_STATE = 0x00100000,
  CLUSTER_CHANGE_NETWORK_DELETED = 0x00200000,
  CLUSTER_CHANGE_NETWORK_ADDED = 0x00400000,
  CLUSTER_CHANGE_NETWORK_PROPERTY = 0x00800000,
  CLUSTER_CHANGE_NETINTERFACE_STATE = 0x01000000,
  CLUSTER_CHANGE_NETINTERFACE_DELETED = 0x02000000,
  CLUSTER_CHANGE_NETINTERFACE_ADDED = 0x04000000,
  CLUSTER_CHANGE_NETINTERFACE_PROPERTY = 0x08000000,
  CLUSTER_CHANGE_QUORUM_STATE = 0x10000000,
  CLUSTER_CHANGE_CLUSTER_STATE = 0x20000000,
  CLUSTER_CHANGE_CLUSTER_PROPERTY = 0x40000000,
  CLUSTER_CHANGE_HANDLE_CLOSE = 0x80000000,
  CLUSTER_CHANGE_ALL
} ;

Constants

 
CLUSTER_CHANGE_NODE_STATE
Value: 0x00000001
The queue receives a notification when a node changes state. For a list of possible node state values, see
GetClusterNodeState.
CLUSTER_CHANGE_NODE_DELETED
Value: 0x00000002
The queue receives a notification when a node is permanently removed from a cluster. A node can be
permanently deleted from an existing cluster with a call to the
EvictClusterNode function.
CLUSTER_CHANGE_NODE_ADDED
Value: 0x00000004
The queue receives a notification when a new node
is added to the cluster. A node can be added only when the Cluster service is initially installed on the
node.
CLUSTER_CHANGE_NODE_PROPERTY
Value: 0x00000008
This notification is reserved for future use.
CLUSTER_CHANGE_REGISTRY_NAME
Value: 0x00000010
The queue receives a notification when the name of a cluster database key has changed.
CLUSTER_CHANGE_REGISTRY_ATTRIBUTES
Value: 0x00000020
The queue receives a notification when a
cluster database key's attributes are changed. The only
currently defined cluster database key attribute is its security descriptor, which can be changed with
ClusterRegSetKeySecurity.
CLUSTER_CHANGE_REGISTRY_VALUE
Value: 0x00000040
The queue receives a notification when a value of the specified cluster database key is changed or deleted.
Cluster database values can be changed with the
ClusterRegSetValue function and deleted with the
ClusterRegDeleteValue function.
CLUSTER_CHANGE_REGISTRY_SUBTREE
Value: 0x00000080
Indicates that the other CLUSTER_CHANGE_REGISTRY_* events apply to the entire
cluster database. If this flag is not included, the events apply only to the specified key.
CLUSTER_CHANGE_RESOURCE_STATE
Value: 0x00000100
The queue receives a notification when a resource changes state. For a list of the possible resource state
values, see GetClusterResourceState.
CLUSTER_CHANGE_RESOURCE_DELETED
Value: 0x00000200
The queue receives a notification when a resource is deleted.
CLUSTER_CHANGE_RESOURCE_ADDED
Value: 0x00000400
The queue receives a notification when a new
resource is created in the cluster.
CLUSTER_CHANGE_RESOURCE_PROPERTY
Value: 0x00000800
The queue receives a notification when the
properties,
dependencies, or
possible owner nodes of a resource change.
CLUSTER_CHANGE_GROUP_STATE
Value: 0x00001000
The queue receives a notification when a group changes state. For a list of the possible group state
values, see GetClusterGroupState.
CLUSTER_CHANGE_GROUP_DELETED
Value: 0x00002000
The queue receives a notification when an existing group is deleted.
CLUSTER_CHANGE_GROUP_ADDED
Value: 0x00004000
The queue receives a notification when a new group is created
in the cluster.
CLUSTER_CHANGE_GROUP_PROPERTY
Value: 0x00008000
The queue receives a notification when the
properties of a group change or when a
resource is added or removed from a group.
CLUSTER_CHANGE_RESOURCE_TYPE_DELETED
Value: 0x00010000
The queue receives a notification when an existing resource type is deleted.
CLUSTER_CHANGE_RESOURCE_TYPE_ADDED
Value: 0x00020000
The queue receives a notification when a new
resource type is created in the cluster.
CLUSTER_CHANGE_RESOURCE_TYPE_PROPERTY
Value: 0x00040000
The queue receives a notification when the
properties of a resource type
change.
CLUSTER_CHANGE_CLUSTER_RECONNECT
Value: 0x00080000
When generated by a client, this value indicates that the RPC connection to a server has been reconnected to another server for the specified cluster. When generated by the server, this value indicates that notification events were dropped by the server for the port.
CLUSTER_CHANGE_NETWORK_STATE
Value: 0x00100000
The queue receives a notification when a network changes state. For a list of the possible network state
values, see GetClusterNetworkState.
CLUSTER_CHANGE_NETWORK_DELETED
Value: 0x00200000
The queue receives a notification when a network is permanently removed from the cluster environment.
CLUSTER_CHANGE_NETWORK_ADDED
Value: 0x00400000
The queue receives a notification when a new
network is added to the cluster environment.
CLUSTER_CHANGE_NETWORK_PROPERTY
Value: 0x00800000
The queue receives a notification when the
properties of an existing network change.
CLUSTER_CHANGE_NETINTERFACE_STATE
Value: 0x01000000
The queue receives a notification when a network interface changes state. For a list of the possible network
interface state values, see
GetClusterNetInterfaceState.
CLUSTER_CHANGE_NETINTERFACE_DELETED
Value: 0x02000000
The queue receives a notification when a network interface is permanently removed from a cluster node.
CLUSTER_CHANGE_NETINTERFACE_ADDED
Value: 0x04000000
The queue receives a notification when a new
network interface is added to a cluster
node.
CLUSTER_CHANGE_NETINTERFACE_PROPERTY
Value: 0x08000000
The queue receives a notification when the
properties of an existing network
interface change.
CLUSTER_CHANGE_QUORUM_STATE
Value: 0x10000000
This notification is reserved for future use.
CLUSTER_CHANGE_CLUSTER_STATE
Value: 0x20000000
The queue receives a notification when the cluster becomes unavailable, meaning that all attempts to
communicate with the cluster fail.
CLUSTER_CHANGE_CLUSTER_PROPERTY
Value: 0x40000000
The queue receives a notification when the cluster's prioritized list of internal
networks changes.
CLUSTER_CHANGE_HANDLE_CLOSE
Value: 0x80000000
The queue receives a notification when a handle associated with a
cluster object is closed.
CLUSTER_CHANGE_ALL

Requirements

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

See also

ClusterRegSetKeySecurity

CreateCluster

Failover Cluster Enumerations

GetClusterNotify

RegisterClusterNotify