DOCUMENT:Q153091  11-JAN-2001  [vbwin]
TITLE   :HOWTO: Find and View the Amount of Free Disk Space on a Drive
PRODUCT :Microsoft Visual Basic for Windows
PROD/VER:WINDOWS:4.0,5.0,6.0
OPER/SYS:
KEYWORDS:kbGrpDSVB

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Visual Basic Learning Edition for Windows, versions 5.0, 6.0 
 - Microsoft Visual Basic Professional Edition for Windows, versions 5.0, 6.0 
 - Microsoft Visual Basic Enterprise Edition for Windows, versions 5.0, 6.0 
 - Microsoft Visual Basic Professional Edition, 32-bit, for Windows, version 4.0 
 - Microsoft Visual Basic Enterprise Edition, 32-bit, for Windows, version 4.0 
-------------------------------------------------------------------------------

SUMMARY
=======

From Visual Basic, it is possible to use the Win32 API function GetDiskFreeSpace
to find and view the amount of free disk space on a specified drive. The code
sample below shows this in practice.

MORE INFORMATION
================

Sample Code
-----------

1. Start a new project in Visual Basic. Form1 is created by default.

2. Remove Form1 from the project.

3. Add a BAS module to the project.

4. Add the following code to the Module1 code window:

      Declare Function GetDiskFreeSpace Lib "kernel32" Alias _
         "GetDiskFreeSpaceA"  (ByVal lpRootPathName As String, _
         lpSectorsPerCluster As Long, lpBytesPerSector As Long, _
         lpNumberOfFreeClusters As Long, lpTotalNumberOfClusters As Long) _
   	As Long

      Public Type DiskInformation
          lpSectorsPerCluster As Long
          lpBytesPerSector As Long
          lpNumberOfFreeClusters As Long
          lpTotalNumberOfClusters As Long
      End Type

      Sub main()
          Dim info As DiskInformation
          Dim lAnswer As Long
          Dim lpRootPathName As String
          Dim lpSectorsPerCluster As Long
          Dim lpBytesPerSector As Long
          Dim lpNumberOfFreeClusters As Long
          Dim lpTotalNumberOfClusters As Long
          Dim lBytesPerCluster As Long
          Dim lNumFreeBytes As Double
          Dim sString As String

          lpRootPathName = "c:\"
          lAnswer = GetDiskFreeSpace(lpRootPathName, lpSectorsPerCluster, _
          lpBytesPerSector, lpNumberOfFreeClusters, lpTotalNumberOfClusters)
          lBytesPerCluster = lpSectorsPerCluster * lpBytesPerSector
          lNumFreeBytes = lBytesPerCluster * lpNumberOfFreeClusters
          sString = "Number of Free Bytes : " & lNumFreeBytes & vbCr & vbLf
          sString = sString & "Number of Free Kilobytes: " & (lNumFreeBytes _
             / 1024) & "K" & vbCr & vbLf
          sString = sString & "Number of Free Megabytes: " & _
             Format(((lNumFreeBytes / 1024) / 1024), "0.00") & "MB"

          MsgBox sString
      End Sub

5. Press the F5 key or choose Start from the Run menu to start the program. You
   will see a message box displaying the free disk space on drive C:.

Additional query words: kbVBp400 kbVBp500 kbVBp600 kbVBp kbdsd kbDSupport KBWIN32SDK KBAPI

======================================================================
Keywords          : kbGrpDSVB 
Technology        : kbVBSearch kbAudDeveloper kbZNotKeyword6 kbZNotKeyword2 kbVB500Search kbVB600Search kbVBA500 kbVBA600 kbVB500 kbVB600 kbVB400Search kbVB400
Version           : WINDOWS:4.0,5.0,6.0
Issue type        : kbhowto

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 2001.