2.2.3.32 CLUSTER_SHARED_VOLUME_STATE_INFO_EX

The CLUSTER_SHARED_VOLUME_STATE_INFO_EX structure<29> contains information about the cluster shared volume for which a notification was generated. See section 2.2.2.21 for details.

CLUSTER_SHARED_VOLUME_STATE_INFO_EX is a custom-marshaled structure that has fields as follows.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

szVolumeName (520 bytes)

...

...

szNodeName (520 bytes)

...

...

VolumeState

szVolumeFriendlyName (520 bytes)

...

...

RedirectedIOReason

...

BlockRedirectedIOReason

...

szVolumeName (520 bytes): A buffer of 16-bit Unicode characters that MUST contain the null-terminated name of the volume in the volume GUID format. For example: 

 \\?\Volume{00000000-0000-0000-0000-000000000000}\

The buffer MUST be padded with additional null characters from the end of the volume name plus null-termination to the end of the buffer. The client MUST ignore any such padding.

szNodeName (520 bytes): A buffer of 16-bit Unicode characters representing the name of the node that generated the notification. This buffer MUST contain the node name as a null-terminated Unicode string. If the node name is less than the size of the buffer, the string MUST be padded with null characters. Any such padding MUST be ignored.

VolumeState (4 bytes): A 32-bit integer that MUST contain one of the following values, indicating the state of the cluster shared volume:

Value

Meaning

SharedVolumeStateUnavailable

0x00000000

The shared volume is unavailable.

SharedVolumeStatePaused

0x00000001

The shared volume is paused.

SharedVolumeStateActive

0x00000002

The shared volume is active.

SharedVolumeStateActiveRedirected

0x00000003

The shared volume is active and in redirected mode.

SharedVolumeStateActiveBlockRedirected

0x00000004

The shared volume is active and in block redirected mode.

szVolumeFriendlyName (520 bytes): A buffer of 16-bit Unicode characters that MUST contain the name of the cluster shared volume for which the notification was generated. This buffer MUST contain the name as a null-terminated Unicode string. If the volume name is less than the size of the buffer, the string MUST be padded with null characters. The client MUST ignore any such padding.

RedirectedIOReason (8 bytes): A 64-bit integer that MUST contain the bitwise OR of one or more of the following values:

Value

Meaning

RedirectedIOReasonNotRedirected

0x0000000000000000

Indicates that the cluster shared volume redirected mode is FALSE.

RedirectedIOReasonUserRequest

0x0000000000000001

Indicates that the cluster shared volume redirected mode is TRUE due to a client request, such as via the CLUSCTL_RESOURCE_DISABLE_SHARED_VOLUME_DIRECTIO (section 3.1.4.3.1.53) method.

RedirectedIOReasonIncompatibleFileSystemFilter

0x0000000000000002

Indicates that the cluster shared volume redirected mode is TRUE due to an incompatible component that is configured with a file system of the storage-class resource associated with the cluster shared volume. What the server considers an incompatible component and how the server identifies the incompatible component are implementation-specific.

RedirectedIOReasonIncompatibleVolumeFilter

0x0000000000000004

Indicates that the cluster shared volume redirected mode is TRUE due to an incompatible component configured with a volume of the storage-class resource associated with the cluster shared volume. What the server considers an incompatible component and how the server identifies the incompatible component are implementation-specific.

RedirectedIOReasonFileSystemConfiguration

0x0000000000000008

Indicates that the cluster shared volume redirected mode is TRUE due to the configuration of the file system of the storage-class resource associated with the cluster shared volume. What the server considers a valid file system configuration for redirected mode and how the server identifies the valid configuration are implementation-specific.

RedirectedIOReasonVolumeEncryption

0x0000000000000010

Indicates that the cluster shared volume redirected mode is TRUE due to an encryption operation on the storage object represented by the storage-class resource associated with the cluster shared volume. What constitutes an encryption operation is implementation-specific.

BlockRedirectedIOReason (8 bytes): A 64-bit integer that MUST contain the bitwise OR of one or more of the following values:

Value

Meaning

BlockRedirectedIOReasonNotRedirected

0x0000000000000000

Indicates that the cluster shared volume block redirected mode is FALSE.

BlockRedirectedIOReasonNoDiskConnectivity

0x0000000000000001

Indicates that the cluster shared volume block redirected mode is TRUE because the server is not connected to the disk.

BlockRedirectedIOReasonStorageSpaceNotAttached

0x0000000000000002

Indicates that the cluster shared volume block redirected mode is TRUE because the storage-class resource associated with the cluster shared volume is formed from a storage pool and can only be accessed by the server via network communication to a different node.

Show: