PersistentState
Specifies whether the resource should be brought online or left offline when the Cluster service is started. The following table summarizes the attributes of the PersistentState property.
Attribute | Value |
---|---|
Data type | DWORD |
Access | Read/write |
Structure | CLUSPROP_DWORD |
Minimum | FALSE |
Maximum | TRUE |
Default | FALSE |
Remarks
The data value for the PersistentState property can be set to TRUE or FALSE. When PersistentState is set to TRUE, the resource is automatically brought online when the Cluster service starts. When set to FALSE, it is left offline.
When a resource is brought online, its PersistentState property is deleted from the cluster database. Therefore, PersistentState should only be set when a resource is offline.
To retrieve the current state of a resource, call the GetClusterResourceState function.
Examples
The property value portion of a property list entry for PersistentState can be set with the following example code:
DWORD PersistentStateData = FALSE;
CLUSPROP_DWORD PersistentStateValue;
PersistentStateValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
PersistentStateValue.cbLength = sizeof(DWORD);
PersistentStateValue.dw = PersistentStateData;
Requirements
Minimum supported client |
None supported |
Minimum supported server |
Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |