Drive

[The Drive property is available for use in Windows Server 2003. It may be altered or unavailable in subsequent versions.]

Specifies the drive letter for the Physical Disk resource. The following table summarizes the attributes of the Drive property.

Attribute Value
Data type
Null-terminated Unicode string
Access
Read/write
Status
Required
Structure
CLUSPROP_SZ
Minimum
NULL
Maximum
None (but see Maximum String Size).
Default
NULL

Remarks

The Drive property is used to create Physical Disk resources with the command-line tool Cluster.exe. Make sure that the assigned drive letter does not conflict with existing drive letters anywhere in the cluster, including each node's local drives.

The CLUSPROP_SZ_DECLARE macro creates a CLUSPROP_SZ structure with an array of the correct size.

Examples

The property value portion of a property list entry for Drive can be set with the following example code.

WCHAR                szDriveData[] = L"D:";
CLUSPROP_SZ_DECLARE( DriveValue, 
                     sizeof( szDriveData ) / sizeof( WCHAR ) );

DriveValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_SZ;
DriveValue.cbLength  = sizeof( szDriveData );
StringCbCopy( DriveValue.sz, DriveValue.cbLength, szDriveData );

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2003 Enterprise, Windows Server 2003 Datacenter
End of server support
Windows Server 2003 Datacenter, Windows Server 2003 Enterprise

See also

Physical Disk Private Properties

CLUSPROP_SZ

CLUSPROP_SZ_DECLARE