CLUSPROP_PARTITION_INFO_EX structure

Specifies a collection of information about a physical disk resource, such as its device name and volume label. The CLUSPROP_PARTITION_INFO_EX structure contains information relevant to storage class resources. It is used as an entry in a value list and consists of:

For convenience, the CLUSPROP_VALUE and CLUS_PARTITION_INFO_EX members are listed explicitly.

Syntax


typedef struct _CLUSPROP_PARTITION_INFO_EX {
  CLUSPROP_SYNTAX Syntax;
  DWORD           cbLength;
  DWORD           dwFlags;
  WCHAR           szDeviceName[MAX_PATH];
  WCHAR           szVolumeLabel[MAX_PATH];
  DWORD           dwSerialNumber;
  DWORD           rgdwMaximumComponentLength;
  DWORD           dwFileSystemFlags;
  WCHAR           szFileSystem[32];
  ULARGE_INTEGER  TotalSizeInBytes;
  ULARGE_INTEGER  FreeSizeInBytes;
  DWORD           DeviceNumber;
  DWORD           PartitionNumber;
  GUID            VolumeGuid;
} CLUSPROP_PARTITION_INFO_EX, *PCLUSPROP_PARTITION_INFO_EX;

Members

Syntax

Member of the CLUSPROP_VALUE structure with a value of CLUSPROP_SYNTAX_PARTITION_INFO_EX (0x000d0001).

cbLength

Member of the CLUSPROP_VALUE structure indicating the count of bytes in the CLUSPROP_PARTITION_INFO_EX structure.

dwFlags

Member of the CLUS_PARTITION_INFO_EX structure that describes the storage class resource, enumerated by the CLUSPROP_PIFLAGS enumeration.

Partition flag valueMeaning
CLUSPROP_PIFLAG_STICKY
1

The drive letter is sticky.

CLUSPROP_PIFLAG_REMOVABLE
2

The storage class resource is removable.

CLUSPROP_PIFLAG_USABLE
4

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

CLUSPROP_PIFLAG_DEFAULT_QUORUM
8

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

Member of the CLUS_PARTITION_INFO_EX structure that describes the device name for the storage class resource, such as C:. No backslashes are included.

szVolumeLabel

Member of the CLUS_PARTITION_INFO_EX structure that describes the volume label for the storage class resource.

dwSerialNumber

Member of the CLUS_PARTITION_INFO_EX structure that describes the serial number of the storage class resource volume.

rgdwMaximumComponentLength

Member of the CLUS_PARTITION_INFO_EX structure that describes the maximum length, in characters, of a file name component supported by the specified file system. A file name component is that portion of a file name between backslashes.

dwFileSystemFlags

Member of the CLUS_PARTITION_INFO_EX structure that describes the file system. One or more of the following flags are valid.

FlagMeaning
FS_CASE_SENSITIVE
1

The file system supports case-sensitive file names.

FS_CASE_IS_PRESERVED
2

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

FS_UNICODE_STORED_ON_DISK
4

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

FS_PERSISTENT_ACLS
8

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

 

szFileSystem

Member of the CLUS_PARTITION_INFO_EX structure that describes the name of the file system, such as "FAT" or "NTFS".

TotalSizeInBytes

Member of the CLUS_PARTITION_INFO_EX structure that identifies the total size, in bytes, of the specified storage class resource.

FreeSizeInBytes

Member of the CLUS_PARTITION_INFO_EX structure that identifies the amount of unallocated space, in bytes, of the specified storage class resource.

DeviceNumber

Member of the CLUS_PARTITION_INFO_EX structure that contains an unsigned 32-bit integer indicating the unique device number.

PartitionNumber

Member of the CLUS_PARTITION_INFO_EX structure that identifies the partition number of the specified storage class resource.

VolumeGuid

Member of the CLUS_PARTITION_INFO_EX structure that takes a 128-bit value that contains the unique identifier associated with that volume.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 Datacenter, Windows Server 2008 Enterprise

Header

ClusAPI.h

See also

Data structures
CLUSPROP_SYNTAX
CLUSPROP_VALUE
CLUS_PARTITION_INFO_EX
CLUSPROP_PARTITION_INFO
CLUSPROP_PIFLAGS

 

 

Show:
© 2014 Microsoft