CLUS_PARTITION_INFO structure (clusapi.h)

Article
09/01/2022

Contains data describing a storage class resource volume and file system. It is used as the data member of a CLUSPROP_PARTITION_INFO structure and as the return value of some control code operations.

Syntax

typedef struct CLUS_PARTITION_INFO {
  DWORD dwFlags;
  WCHAR szDeviceName[MAX_PATH];
  WCHAR szVolumeLabel[MAX_PATH];
  DWORD dwSerialNumber;
  DWORD rgdwMaximumComponentLength;
  DWORD dwFileSystemFlags;
  WCHAR szFileSystem[32];
} CLUS_PARTITION_INFO, *PCLUS_PARTITION_INFO;

Members

dwFlags

Flags that describes the storage class resource, enumerated by the CLUSPROP_PIFLAGS enumeration.

CLUSPROP_PIFLAG_STICKY (0x00000001)

The drive letter is sticky.

CLUSPROP_PIFLAG_REMOVABLE (0x00000002)

The storage class resource is removable.

CLUSPROP_PIFLAG_USABLE (0x00000004)

The storage class resource is formatted with a file system that is usable by the Cluster service.

CLUSPROP_PIFLAG_DEFAULT_QUORUM (0x00000008)

The partition should be used to store quorum files if no partition is specified in the SetClusterQuorumResource function. For Physical Disk resources, the smallest NTFS partition larger than 50MB automatically receives this flag.

szDeviceName[MAX_PATH]

Device name for the storage class resource, such as "C:". No backslash is included.

szVolumeLabel[MAX_PATH]

Volume label for the storage class resource.

dwSerialNumber

Serial number of the storage class resource volume.

rgdwMaximumComponentLength

Value of the maximum length, in characters, of a file name component supported by the specified file system. A file name component is the portion of a file name between backslashes.

dwFileSystemFlags

Value that describes the file system. One or more of the following flags are valid.

FS_CASE_IS_PRESERVED (0x00000002)

The file system preserves the case of file names when it places a name on the storage class resource.

FS_CASE_SENSITIVE (0x00000001)

The file system supports case-sensitive file names.

FS_UNICODE_STORED_ON_DISK (0x00000004)

The file system supports Unicode in file names as they appear on storage class resource.

FS_PERSISTENT_ACLS (0x00000008)

The file system preserves and enforces access control lists (ACLs).

szFileSystem[32]

Name of the file system, such as "FAT" or "NTFS".

Remarks

A CLUS_PARTITION_INFO structure can be returned by ClusterResourceControl when the dwControlCode parameter is set to CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO and can be returned by ClusterResourceTypeControl when dwControlCode is set to CLUSCTL_RESOURCE_TYPE_STORAGE_GET_AVAILABLE_DISKS.

Examples

See Creating Physical Disk Resources.

Requirements

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