MSCluster_EventResourceStateChange class

A WMI class that represents a resource state change event.

The following syntax is simplified from MOF code, and includes all inherited properties.

Syntax

[Dynamic, Provider("MS_CLUSTER_PROVIDER"), UUID("{F1163D38-0E12-49ed-B0AF-09C683F89243}"), AMENDMENT]
class MSCluster_EventResourceStateChange : MSCluster_EventStateChange
{
  uint8  SECURITY_DESCRIPTOR[];
  uint64 TIME_CREATED;
  uint32 EventTypeMajor;
  uint32 EventTypeMinor;
  string EventObjectName;
  uint32 EventObjectType;
  string EventObjectPath;
  uint32 EventNewState;
  string EventNode;
  string EventGroup;
};

Members

The MSCluster_EventResourceStateChange class has these types of members:

Properties

The MSCluster_EventResourceStateChange class has these properties.

EventGroup

Data type: string

Access type: Read-only

Current group that contains this resource.

EventNewState

Data type: uint32

Access type: Read-only

Current state of the object that is reporting a state change.

EventObjectType value Enumeration
2 (Node Object)
CLUSTER_NODE_STATE
3 (Group object)
CLUSTER_GROUP_STATE
4 (Resource Object)
CLUSTER_RESOURCE_STATE
6 (Network Object)
CLUSTER_NETWORK_STATE
7 (Network Interface Object)
CLUSTER_NETINTERFACE_STATE

This property is inherited from MSCluster_EventStateChange.

EventNode

Data type: string

Access type: Read-only

Current node that is hosting this group.

EventObjectName

Data type: string

Access type: Read-only

Provides the name of the object to which this event applies.

This property is inherited from MSCluster_Event.

EventObjectPath

Data type: string

Access type: Read-only

Provides the WMI path of the object to which this event applies.

This property is inherited from MSCluster_Event.

EventObjectType

Data type: uint32

Access type: Read-only

(0)

Handle

(1)

Cluster

(2)

Node

(3)

Group

(4)

Resources

(5)

Resource type

(6)

Network

(7)

Network interface

(8)

Registry

(9)

Quorum

Provides the type of object to which this event applies.

This property is inherited from MSCluster_Event.

EventTypeMajor

Data type: uint32

Access type: Read-only

Provides the major event category. A value of 0 indicates an event returned by GetClusterNotify.

This property is inherited from MSCluster_Event.

EventTypeMinor

Data type: uint32

Access type: Read-only

Provides the subtype within the major category. When the EventTypeMajor property is 0, this subtype contains the cluster event value that GetClusterNotify returns.

This property is inherited from MSCluster_Event.

SECURITY_DESCRIPTOR

Data type: uint8 array

Access type: Read-only

Descriptor used by the event provider to determine which users can receive the event. This property is inherited from __Event. For more information about constants used to set this security descriptor, see WMI Security Constants.

TIME_CREATED

Data type: uint64

Access type: Read-only

Unique value that indicates the time at which the event was generated. This is a 64-bit value that represents the number of 100-nanosecond intervals after January 1, 1601. The information is in the Coordinated Universal Times (UTC) format. This property is inherited from __Event.

For more information about using uint64 values in scripts, see Scripting in WMI.

Remarks

The MSCluster_EventResourceStateChange class is derived from the MSCluster_EventStateChange class.

Examples

The following WMI script shows you how to trap failover cluster events.

'''''''''''''''''''''''''''''''''''
' Failover Cluster Documentation:
' Example code for the MSCluster_EventResorceStateChange class topic.
'''''''''''''''''''''''''''''''''''

Option Explicit

Dim objClusterEvent
Dim objClusterEvents
Dim objClusterService
Dim objSWbemLocator
Dim strQuery            
    
' Query for all resource state change events 
' (CLUSTER_CHANGE_RESOURCE_STATE = 0x00000100 = 256)
strQuery = "select * from MSCluster_Event where EventTypeMinor = 256"

Set objSWbemLocator   = CreateObject("WbemScripting.SWbemLocator")
Set objClusterService = objSWbemLocator.ConnectServer("", "Root\MSCluster")    
Set objClusterEvents  = objClusterService.ExecNotificationQuery(strQuery)

Do
  Set objClusterEvent = objClusterEvents.NextEvent(300000)    
  If Err = 0 Then
    WScript.Echo " Object Name     : " & objClusterEvent.EventObjectName
  WScript.Echo " EventTypeMinor  : 0x" & hex(objClusterEvent.EventTypeMinor)
  WScript.Echo " EventObjectType : " & objClusterEvent.EventObjectType
  End If
Loop

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2008
Namespace
Root\MSCluster
MOF
ClusWmi.mof
DLL
ClusWMI.dll