Navigation:  Reference > Functions By Category > Files and filenames >

GetDriveInfo()

Previous pageReturn to chapter overviewNext page

Return a _TDriveInfo_() object with the info of the specified drive.

 

Syntax:

GetDriveInfo(<cRoot>) -> oInfo

 

Parameters:

<cRoot>

A string that contains the root directory of the volume to be described. A trailing backslash is required. For example, you would specify \\MyServer\MyShare as \\MyServer\MyShare\, or the C drive as "C:\".

 

Return Value:

Object of the class _TDriveInfo_() with the following properties:

oInfo:cRoot

Root of the described volume.

oInfo:cLabel

Label of the described volume.

oInfo:nSerial

Serial number of the described volume.

oInfo:nMaxCompLen

Maximum length of a file name component supported by a specified file system.

A file name component is the portion of a file name between backslashes.

oInfo:cFileSystem

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

oInfo:nDriveType

One of the following values:

DRIVE_UNKNOWN         0

DRIVE_NO_ROOT_DIR     1

DRIVE_REMOVABLE       2

DRIVE_FIXED           3

DRIVE_REMOTE          4

DRIVE_CDROM           5

DRIVE_RAMDISK         6

oInfo:lNamedStreams

.T. if the file system supports named streams.

oInfo:lReadOnlyVolume

.T. if the specified volume is read-only.

Windows 2000/NT and Windows Me/98/95: Always .F.

oInfo:lObjectIds

.T. if the file system supports object identifiers.

oInfo:lReparsePoints

.T. if the file system supports re-parse points.

oInfo:lSupportsSparseFiles

.T. if the file system supports sparse files.

oInfo:lVolumeQuotas

.T. if the file system supports disk quotas.

oInfo:lCaseIsPreserved

.T. if the file system preserves the case of file names when it places a name on disk.

oInfo:lCaseSensitive

.T. if the file system supports case-sensitive file names.

oInfo:lFileCompression

.T. if the file system supports file-based compression.

oInfo:lFileEncryption

.T. if the file system supports the Encrypted File System

oInfo:lPersistentAcls

.T. if the file system preserves and enforces access control lists (ACL). For example, the NTFS file system preserves and enforces ACLs, and the FAT file system does not.

oInfo:lUnicodeStoredOnDisk

.T. if the file system supports Unicode in file names as they appear on disk.

oInfo:lVolIsCompressed

.T. if the specified volume is a compressed volume; for example, a DoubleSpace volume.