GetDiskFreeSpace
von ActiveVB-Team
Deklaration
Declare Function GetDiskFreeSpace Lib "kernel32" _ Alias "GetDiskFreeSpaceA" ( _ ByVal lpRootPathName As String, _ lpSectorsPerCluster As Long, _ lpBytesPerSector As Long, _ lpNumberOfFreeClusters As Long, _ lpTotalNumberOfClusters As Long) As LongWeitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel GetDiskFreeSpace des API-Wikis.
GetDiskFreeSpace ermittelt Formatinformationen über eine Platte, zusammen mit der Anzahl freier Cluster.
Parameter | |
---|---|
pRootPathNam | Zeiger auf einen String, der den Pfad des Hauptverzeichnisses für das abgefragte Gerät enthält. Um z.B. Informationen über das Laufwerk C zu erhalten, ist der Pfadname "C:\" anzu geben. Anmerkung: Diese Funktion ist auf Laufwerke mit bis zu 2GB beschränkt. Für größere Laufwerke ist die GetDiskFreeSpaceEx zu verwenden. |
lpSectorsPerCluster | Ein Zeiger auf ein DWORD, das die Anzahl der Sektoren pro Cluster aufnimmt. Ein Sektor ist eine fortlaufende Gruppe von Bytes, die auf einer Platte gespeichert sind. Ein Cluster ist ein Sektorblock. |
lpNumberOfFreeClusters | Ein Zeiger auf ein DWORD, das die Anzahl der Bytes pro Sektor aufnimmt. Um die Anzahl der Bytes pro Cluster zu ermitteln, ist der in lpSectorsPerCluster zurückgegebene Wert mit pBytesPerSector zu multiplizieren. |
lpTotalNumberOfClusters | Zeiger auf ein DWORD, das die Anzahl der freien Cluster aufnimmt. Der freie Platz auf der Platte wird durch Multiplikation dieses Wertes mit der Anzahl der Sektoren pro Cluster und der Anzahl der Bytes pro Sektor. Achtung: Bei verwendeter Datenkomprimierung sind die auf diese Weiser ermittelten Werte stark verzerrt. |
lpBytesPerSector | Zeiger auf ein DWORD, das die Gesamtzahl der Cluster auf dem Laufwerk aufnimmt. |
Tabelle 1
Rückgabewerte | |
---|---|
TRUE | Die Funktion wurde erfolgreich ausgeführt. |
FALSE | Es lag ein Fehler vor. |
Tabelle 2
Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT
Verwandte API-Funktionen
GetDriveType, GetDiskFreeSpaceEx
Zugehörige Tipps
Zugehörige Microsoft Knowledge Base Artikel