The FailoverThreshold property specifies the number of attempts at failover that are made before the Cluster Service concludes that the group cannot be brought online anywhere in the cluster.
| Type: | DWORD |
| Access: | Read/write |
| Function: | ClusterGroupControl |
| Structure: | CLUSPROP_DWORD |
| Control Code: | CLUSCTL_GROUP_GET_COMMON_PROPERTIES |
When ClusterGroupControl processes the CLUSCTL_GROUP_GET_COMMON_PROPERTIES control code, it returns a property list that includes the FailoverThreshold property as one of the entries. The property value portion of the entry contains a CLUSPROP_DWORD structure that is set as follows:
DWORD FailoverThresholdData = 5;
CLUSPROP_DWORD FailoverThresholdValue;
FailoverThresholdValue.Syntax = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
FailoverThresholdValue.cbLength = sizeof(DWORD);
FailoverThresholdValue.dw = FailoverThresholdData;
The FailoverThreshold property specifies the number of attempts within a number of hours defined by the FailoverPeriod property that the Cluster Service can try to failover the group. For example, if FailoverThreshold is set to two and RestartPeriod is set to one, then a node can tolerate two failover attempts of the group within any one hour interval. On the third failover attempt within one hour, the node will not attempt to move the group. More than three failover attempts can occur, as long as they occur over an interval that is greater than one hour.
If a value for FailoverThreshold is not specified, the default value is 10.
Version: Use Windows NT Server Enterprise Edition 4.0.
Windows CE: Unsupported.
Header: Declared in clusapi.h.