The RestartPeriod defines a window of time in milliseconds during which a specified number of restart attempts can occur. The RestartThreshold property specifies the allowable number of restart attempts.
| 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 RestartPeriod property as one of the entries. The property value portion of the entry contains a CLUSPROP_DWORD structure that is set as follows:
DWORD RestartPeriodData = 900;
CLUSPROP_DWORD RestartPeriodValue;
RestartPeriodValue.Syntax = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
RestartPeriodValue.cbLength = sizeof(DWORD);
RestartPeriodValue.dw = RestartPeriodData;
The RestartPeriod and RestartThreshold properties work together as follows. If, for example, the RestartPeriod property is set to 200 milliseconds and RestartThreshold property is set to two retry attempts, then a system can tolerate two failures on the resource within any 200 millisecond window. More than two failures can occur, as long as they occur over an interval that is greater than 200 milliseconds. On the third failure within the window, the Cluster Service will attempt to move the group that contains the failed resource to another node.
After the window defined by the RestartPeriod property is exceeded, the Cluster Service resets the property to zero.
If not specified, the default value for the RestartPeriod property is 900 milliseconds.
Version: Use Windows NT Server Enterprise Edition 4.0.
Windows CE: Unsupported.
Header: Declared in clusapi.h.