CLUSTER_REG_COMMAND enumeration (msclus.h)

Enumerates the possible cluster registry commands that a local node will perform when attempting to join a cluster. It is used by the CLUSTER_BATCH_COMMAND and CLUSTER_READ_BATCH_COMMAND structures.

Syntax

typedef enum _CLUSTER_REG_COMMAND {
  CLUSREG_COMMAND_NONE = 0,
  CLUSREG_SET_VALUE = 1,
  CLUSREG_CREATE_KEY,
  CLUSREG_DELETE_KEY,
  CLUSREG_DELETE_VALUE,
  CLUSREG_SET_KEY_SECURITY,
  CLUSREG_VALUE_DELETED,
  CLUSREG_READ_KEY,
  CLUSREG_READ_VALUE,
  CLUSREG_READ_ERROR,
  CLUSREG_CONTROL_COMMAND,
  CLUSREG_CONDITION_EXISTS,
  CLUSREG_CONDITION_NOT_EXISTS,
  CLUSREG_CONDITION_IS_EQUAL,
  CLUSREG_CONDITION_IS_NOT_EQUAL,
  CLUSREG_CONDITION_IS_GREATER_THAN,
  CLUSREG_CONDITION_IS_LESS_THAN,
  CLUSREG_CONDITION_KEY_EXISTS,
  CLUSREG_CONDITION_KEY_NOT_EXISTS,
  CLUSREG_LAST_COMMAND
} CLUSTER_REG_COMMAND;

Constants

CLUSREG_COMMAND_NONE Value: 0 This constant is not a valid command. It and the CLUSREG_LAST_COMMAND constant act as brackets that contain the valid commands.
CLUSREG_SET_VALUE Value: 1 This command sets a value relative to the last executed CLUSREG_CREATE_KEY command or (if not provided) relative to a key passed into the ClusterRegCreateBatch function.
CLUSREG_CREATE_KEY This command will create a specified cluster registry key if it does not exist, or opens an existing one.
CLUSREG_DELETE_KEY This command will delete a key with all values and nested subkeys. No commands that operate on values can follow CLUSREG_DELETE_KEY until CLUSREG_CREATE_KEY is added.
CLUSREG_DELETE_VALUE This command deletes a value relative to the last executed CLUSREG_CREATE_KEY command or (if not provided) relative to a key passed into the ClusterRegCreateBatch function.
CLUSREG_SET_KEY_SECURITY This command is reserved for future use.
CLUSREG_VALUE_DELETED This command is returned only through a batch update notification port. It indicates whether a specific cluster registry value has been deleted or whether the data of that cluster registry value has been changed.
CLUSREG_READ_KEY
CLUSREG_READ_VALUE This command indicates that content was read successfully for the requested value.
CLUSREG_READ_ERROR This command indicates that a value was missing or another error occurred during read.
CLUSREG_CONTROL_COMMAND A control command. Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  This value is not available before Windows Server 2012 R2.
CLUSREG_CONDITION_EXISTS A condition that indicates that a value exists. Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  This value is not available before Windows Server 2016.
CLUSREG_CONDITION_NOT_EXISTS A condition that indicates that a value does not exist. Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  This value is not available before Windows Server 2016.
CLUSREG_CONDITION_IS_EQUAL A condition that indicates that a value is equal to another. Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  This value is not available before Windows Server 2016.
CLUSREG_CONDITION_IS_NOT_EQUAL A condition that indicates that a value is not equal to another. Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  This value is not available before Windows Server 2016.
CLUSREG_CONDITION_IS_GREATER_THAN A condition that indicates that a value is greater than another. Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  This value is not available before Windows Server 2016.
CLUSREG_CONDITION_IS_LESS_THAN A condition that indicates that a value is less than another. Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  This value is not available before Windows Server 2016.
CLUSREG_CONDITION_KEY_EXISTS A condition that indicates that a key exists. Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  This value is not available before Windows Server 2016.
CLUSREG_CONDITION_KEY_NOT_EXISTS
CLUSREG_LAST_COMMAND This constant is not a valid command. It and the CLUSREG_COMMAND_NONE constant act as brackets that contain the valid commands. Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  The value of this constant is lower before Windows Server 2016.

Remarks

The CLUSREG_VALUE_DELETED command precedes every CLUSREG_SET_VALUE and CLUSREG_DELETE_VALUE command in the returned notification data, if the value had existing data.

Requirements

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

See also

CLUSTER_BATCH_COMMAND

CLUSTER_READ_BATCH_COMMAND

ClusterRegCreateBatch

ClusterRegCreateReadBatch

Failover Cluster Enumerations