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 |