PersistentState Property for Groups

The PersistentState property describes the last known persistent state of the group.

Quick Info

Type: DWORD
Access: Read/write
Function: ClusterGroupControl
Structures: CLUSPROP_DWORD
Control Codes: CLUSCTL_GROUP_GET_COMMON_PROPERTIES

Remarks

When ClusterGroupControl processes the CLUSCTL_GROUP_GET_COMMON_PROPERTIES control code, it returns a property list that includes the PersistentState property as one of the entries. The property value portion of the entry contains a CLUSPROP_DWORD structure that is set as follows:

DWORD PersistentStateData = FALSE;
CLUSPROP_DWORD PersistentStateValue;
PersistentStateValue.Syntax = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
PersistentStateValue.cbLength = sizeof(DWORD);
PersistentStateValue.dw = PersistentStateData;
 

The data value for the PersistentState property describes what should happen to the group the next time the Cluster Service is started. Valid values are TRUE and FALSE. When PersistentState is set to TRUE, the group should be brought online. When set to FALSE, it should be left offline.

Resources use their group's PersistentState property when they lack a value for their own PersistentState property.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.