Drives class

A Drives is a read-only collection of Drive objects: the logical drives of the computer. It counts them, returns one by letter or by position, and is enumerated with For Each.

A Drives is not created with New. GetDrives returns one, and FileSystemObject.Drives is the same call. It holds the drives that existed when it was made: a USB disk that is plugged in afterwards is not in it, so call GetDrives again. Each Drive in it asks Windows when it is used. Drives that are not ready, such as an optical drive with no disc, are in the collection; check IsReady before reading the size of one.

Dim ds As Drives, d As Drive
Set ds = GetDrives()
Debug.Print ds.Count
For Each d In ds
    Debug.Print d.DriveLetter, d.IsReady
Next

Dim ds As Drives
Set ds = GetDrives()
Debug.Print ds.Count > 0                              ' True
Debug.Print ds.Item("C").Path                         ' C:
Debug.Print ds(1).Path = ds.Item(1).Path              ' True

Dim ds As Drives, d As Drive
Set ds = GetDrives()

On Error Resume Next
Set d = ds("C:")
Debug.Print Err.Number                 ' 5
Err.Clear
Set d = ds(0)
Debug.Print Err.Number                 ' 9
Err.Clear
On Error GoTo 0

Properties

Count

The number of drives in the collection.

Syntax: object.Count As Long

Item

One drive of the collection. This is the default member.

Syntax: object.Item ( letterOrIndex ) As Drive

letterOrIndex
required A Variant: the drive letter alone, such as "C", without a colon, or the position of the drive, counted from 1.

The drives are in the order of their letters, and the letter is not case-sensitive. A letter that is not in the collection raises error 5, and so does "C:", a letter with a colon. A position below 1 or above Count raises error 9 (Subscript out of range).

The Scripting Runtime accepts "C:", raises error 68 (Device unavailable) for a letter that is not in use, and raises error 5 for a position.

NewEnum

The enumerator that For Each uses. It is hidden, and is not called from code.

Syntax: object.NewEnum As IUnknown

See Also

  • Drive class – the type of its items
  • FileSystemTools module – GetDrives returns this collection
  • Files class and Folders class – the other two collections