2.2.3.32 CLUSTER_SHARED_VOLUME_STATE_INFO_EX

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

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

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.