FailbackWindowEnd Property for Groups

The FailbackWindowEnd property provides the latest time that the group can be moved back to the node identified as its preferred node.

Quick Info

Type: DWORD
Access: Read/write
Function: ClusterGroupControl
Structure: CLUSPROP_DWORD
Control Code: CLUSCTL_GROUP_GET_COMMON_PROPERTIES

Remarks

When ClusterGroupControl processes the CLUSCTL_GROUP_GET_COMMON_PROPERTIES control code, it returns a property list that includes the FailbackWindowEnd property as one of the entries. The property value portion of the entry contains a CLUSPROP_DWORD structure that is set as follows:

DWORD FailbackWindowEndData = 12;
CLUSPROP_DWORD FailbackWindowEndValue;
FailbackWindowEndValue.Syntax = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
FailbackWindowEndValue.cbLength = sizeof(DWORD);
FailbackWindowEndValue.dw = FailbackWindowEndData;
 

The data for the FailbackWindowEnd 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. The time represents local cluster time. 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.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.