Common Group Properties

Common group properties are data values that describe all groups. They are static values stored in the cluster database. To access the common group properties, applications typically call ClusterGroupControl with one of the following values for the dwControlCode parameter:

• CLUSCTL_GROUP_ENUM_COMMON_PROPERTIES to retrieve the names of the common group properties.
• CLUSCTL_GROUP_GET_COMMON_PROPERTIES to retrieve the names and values of common group properties that can be modified.
• CLUSCTL_GROUP_GET_RO_COMMON_PROPERTIES to retrieve the names and values of common group properties that cannot be modified.
• CLUSCTL_GROUP_SET_COMMON_PROPERTIES to update the values of common group properties.
• CLUSCTL_GROUP_VALIDATE_COMMON_PROPERTIES to validate common group properties.

For the get, set, and validate operations, ClusterGroupControl either requires as input or returns as output a property list that contains an entry for every property. Each entry has two parts: a property name and a property value. The property name contains a syntax value, a string describing the name, the length of the string, and padding if necessary to properly align the name. The property value is similar to the name in that it also contains a syntax value and a length. The data portion varies depending on the type of property. For most properties, a cluster structure such as CLUSPROP_SZ or CLUSPROP_DWORD is used to store the property value in the property list.

The Quick Info tables that appear with each property describe the following pieces of information:

• Property type.
• Property access level.
• Functions that can be called to access the property such as ClusterGroupControl.
• Structures that are used as input to or output from a property operation.
• Control codes that can be passed to ClusterGroupControl to retrieve the property.