FailoverThreshold
Specifies the maximum number of failover attempts that can be made on a group within a time interval defined by FailoverPeriod. The following table summarizes the attributes of the FailoverThreshold property.
| Attribute | Value |
|---|---|
| Data type | DWORD |
| Access | Read/write |
| Structure | CLUSPROP_DWORD |
| Minimum | 0 |
| Maximum | 0xFFFFFFFF |
| Default | 0xFFFFFFFF |
Remarks
If the Cluster service exceeds the number of failover attempts specified by FailoverThreshold within the time interval specified by FailoverPeriod, it stops trying to fail over the group.
For example, if FailoverThreshold is set to 2 and RestartPeriod is set to 1, a node can tolerate 2 failover attempts of the group within any 1-hour interval. More than 3 failover attempts can occur, as long as they occur over an interval that is greater than 1 hour.
If a value for FailoverThreshold is not specified, the default value is the number of nodes in the cluster minus 1. This is represented as 0xFFFFFFFF.
Examples
The property value portion of a property list entry for FailoverThreshold can be set with the following example code:
DWORD FailoverThresholdData = 5;
CLUSPROP_DWORD FailoverThresholdValue;
FailoverThresholdValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
FailoverThresholdValue.cbLength = sizeof(DWORD);
FailoverThresholdValue.dw = FailoverThresholdData;
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |