The RestartAction property describes the action to perform if the resource fails.
Type: | DWORD |
Access: | Read/write |
Function: | ClusterResourceControl |
Structure: | CLUSPROP_DWORD |
Control Code: | CLUSCTL_RESOURCE_GET_COMMON_PROPERTIES |
The RestartAction property allows a network administrator to control how resource failures affect other resources in the group. If not specified, the default behavior is to have failures to resources affect the group to which they belong, possibly causing group failover to occur.
When ClusterResourceControl processes the CLUSCTL_RESOURCE_GET_COMMON_PROPERTIES control code, it returns a property list that includes the RestartAction property as one of the entries. The property value portion of the entry contains a CLUSPROP_DWORD structure that is set as follows:
DWORD RestartActionData = ClusterResourceDontRestart;
CLUSPROP_DWORD RestartActionValue;
RestartActionValue.Syntax = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
RestartActionValue.cbLength = sizeof(DWORD);
RestartActionValue.dw = RestartActionData;
The data value for the RestartAction property can be set to ClusterResourceRestartNoNotify or ClusterResourceRestartNotify in addition to ClusterResourceDontRestart. The following table describes each setting:
RestartAction value | Description |
---|---|
ClusterResourceDontRestart | Do not restart the resource after a failure. |
ClusterResourceRestartNoNotify | If the resource exceeds its restart threshold within its restart period, do not attempt to fail the group over to another node in the cluster. |
ClusterResourceRestartNotify | If the resource exceeds its restart threshold within its restart period, attempt to fail the group over to another node in the cluster. |
Version: Use Windows NT Server Enterprise Edition 4.0.
Windows CE: Unsupported.
Header: Declared in clusapi.h.