The FailbackWindowStart property provides the earliest time that the group can be moved back to the node identified as its preferred node.
| 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 FailbackWindowStart property as one of the entries. The property value portion of the entry contains a CLUSPROP_DWORD structure that is set as follows:
DWORD FailbackWindowStartData = 10;
CLUSPROP_DWORD FailbackWindowStartValue;
FailbackWindowStartValue.Syntax = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
FailbackWindowStartValue.cbLength = sizeof(DWORD);
FailbackWindowStartValue.dw = FailbackWindowStartData;
The data for the FailbackWindowStart property is a number between 0, which represents midnight, and 23, which represents 11:00 p.m., or – 1. The – 1 indicates that there is no failback window.
The FailbackWindowStart and FailbackWindowEnd properties define an amount of time within a 24-hour period that a group can failback. FailbackWindowStart may be less than or greater than FailbackWindowEnd, depending on the window. For example, if the window is from 10 P.M. until 2 A.M., FailbackWindowStart is set to 10 and FailbackWindowEnd to 2. For a failback window to exist, the group must have a value for both the FailbackWindowStart and FailbackWindowEnd properties if a failback window does not exist because the group is missing one or both of these properties, failback operations occur immediately after the preferred node has restarted.
When a node reboots and determines that it should fail back a group, it checks the current system time. If this time is not within the window defined by the FailbackWindowStart and FailbackWindowEnd properties, the node waits until the current time falls within this window before beginning the failback process.
If the current owner of the group fails before the failback window can be reached, every group hosted by the failed node is moved regardless of the failback windows settings.
Note The time for a failback window represents local cluster time.
Version: Use Windows NT Server Enterprise Edition 4.0.
Windows CE: Unsupported.
Header: Declared in clusapi.h.