RestartAction Property for Resources

The RestartAction property describes the action to perform if the resource fails.

Quick Info

Type: DWORD
Access: Read/write
Function: ClusterResourceControl
Structure: CLUSPROP_DWORD
Control Code: CLUSCTL_RESOURCE_GET_COMMON_PROPERTIES

Remarks

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.

QuickInfo

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