Edit

CLUSCTL_RESOURCE_STATE_CHANGE_REASON_STRUCT structure (clusapi.h)

  • Article

Sent with the CLUSCTL_RESOURCE_STATE_CHANGE_REASON control code to provide the reason for a resource state change.

Syntax

typedef struct _CLUSCTL_RESOURCE_STATE_CHANGE_REASON_STRUCT {
  DWORD                                dwSize;
  DWORD                                dwVersion;
  CLUSTER_RESOURCE_STATE_CHANGE_REASON eReason;
} CLUSCTL_RESOURCE_STATE_CHANGE_REASON_STRUCT, *PCLUSCTL_RESOURCE_STATE_CHANGE_REASON_STRUCT;

Members

dwSize

The size of the structure in bytes.

dwVersion

The version of the structure. Set to CLUSCTL_RESOURCE_STATE_CHANGE_REASON_VERSION_1 (1).

eReason

A value of the CLUSTER_RESOURCE_STATE_CHANGE_REASON enumeration that describes the reason for the state change. The following list lists the possible values.

eResourceStateChangeReasonUnknown (0)

This reason code is never sent by the cluster. Resource DLLs should use this value to initialize a local CLUSCTL_RESOURCE_STATE_CHANGE_REASON_STRUCT structure and to reset the eReason member of this structure before returning from the Offline and Terminate entry point functions. For more information, see CLUSCTL_RESOURCE_STATE_CHANGE_REASON.

eResourceStateChangeReasonMove (1)

Offline is about to be called because the resource's group is being moved.

eResourceStateChangeReasonFailover (2)

Terminate is about to be called because the resource's group is being failed over.

eResourceStateChangeReasonFailedMove (3)

Online is about to be called because the resource's group did not successfully complete a move operation.

eResourceStateChangeReasonShutdown (4)

Offline is about to be called because the Cluster service is being shut down.

eResourceStateChangeReasonRundown (5)

Terminate is about to be called because the Cluster service has stopped unexpectedly.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2008 Datacenter, Windows Server 2008 Enterprise
Header clusapi.h

See also

CLUSTER_RESOURCE_STATE_CHANGE_REASON

Utility Structures