The PersistentState property describes the last known persistent state of the resource.
| Type: | DWORD |
| Access: | Read/write |
| Function: | ClusterResourceControl |
| Structure: | CLUSPROP_DWORD |
| Control Code: | CLUSCTL_RESOURCE_GET_COMMON_PROPERTIES |
When ClusterResourceControl processes the CLUSCTL_RESOURCE_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 resource the next time the Cluster Service is started. Valid values are TRUE and FALSE. When PersistentState is set to TRUE, the resource should be brought online. When set to FALSE, it should be left offline. Typically, resources inherit their state from the state of the group to which they belong. When that state differs, as can happen when the group is online and the resource is offline, the PersistentState property of the resource is saved as FALSE.
A resource remains offline until the network administrator manually brings it back online. When it is brought online, the resource's PersistentState property is deleted from the cluster database. Because a resource cannot be online if its group is offline, it makes no sense to save the resource's PersistentState property unless the resource is offline.
To retrieve the current state of a resource, call the GetClusterResourceState function.
Version: Use Windows NT Server Enterprise Edition 4.0.
Windows CE: Unsupported.
Header: Declared in clusapi.h.