GetVolumeInformation

Deklaration  

Declare Function GetVolumeInformation Lib "kernel32" _
                 Alias "GetVolumeInformationA" ( _
                 ByVal lpRootPathName As String, _
                 ByVal lpVolumeNameBuffer As String, _
                 ByVal nVolumeNameSize As Long, _
                 lpVolumeSerialNumber As Long, _
                 lpMaximumComponentLength As Long, _
                 lpFileSystemFlags As Long, _
                 ByVal lpFileSystemNameBuffer As String, _
                 ByVal nFileSystemNameSize As Long) As Long

Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel GetVolumeInformation des API-Wikis.

GetVolumeInformation gibt die Datenträgerbezeichnung sowie Daten zum Dateisystem des benannten Laufwerkes zurück.

Parameter
lpRootPathName	Zeiger auf einen String, der den Pfadnamen des Rootverzeichnisses für den angegebenen Datenträger enthält. Dabei muß es sich um einen nullterminierten String handeln. Wird dieser Parameter auf Null gesetzt, wird das aktuelle Laufwerke genommen.
lpVolumeNameBuffer	Zeiger auf einen Puffer, in dem der Datenträgername als nullterminierter Strin ggespeichert wird. Ein Datenträgername wird gesetzt, wenn dieser formatiert wird, oder mit Hilfe des Eigenschaftendialogs im Explorer.
nVolumeNameSize	Die anzahl der Bytes im Puffer lpVolumeNameBuffer.
lpVolumeSerialNumber	Zeiger auf ein DWORD, das die Seriennummer des Datenträgers aufnimmt. Das kann Null sein, wenn keine Seriennummer erforderlich ist.
lpMaximumComponentLength	Zeiger auf ein DWORD, das die maximale Länge einer Komponente im Pfadnamen aufnimmt. Eine Dateisystemkomponente ist ein beliebiger Teil des Namens zwischen den Backslashes [\]. Im VFAT-Dateisystem (unter Windows 95) oder NTFS(Eindows NT) werden lange Dateinamen unterstützt, und die Rückgabe ist 255. Das ist die einzige Information im System, die darauf hinweist, daß lange Dateinamen unterstützt werden.
lpFileSystemFlags	Zeiger auf ein DWORD, das die Dateisystemattribute anhand der unten stehenden Tabelle beschreibt.
lpFileSystemNameBuffer	Zeiger auf einen Puffer, der den Namen des Dateisystems aufnimmt. Das System gibt einen nullterminierten String zurück. Das kann Null sein, wenn kein Dateisystemname erforderlich ist.
nFileSystemNameSize	Die Anzahl der Zeichen im Puffer lpFileSystemNameBuffer Dieser Parameter wird ignoriert, wenn lpFileSystemNameBuffer gleich Null ist.

Tabelle 1

Dateisystemattribute
FS_CASE_IS_PRESERVED	Die Groß- Kleinschreibung aller alphabetischer Zeichen wird im Dateinamen auf der Platte beibehalten.
FS_CASE_SENSITIVE	Das Dateisystem ist in der Lage, bei einer Suche nach Groß- Kleinschreibung zu unterscheiden.
FS_PRESISTENT_ACLS	Das Dateisystem speichert Zugriffskontroll-Listen (ACL) für die Daten, die dort gespeichert werden, und nutzt sie für die Steuerung des Zugriffs. NTFS ist ein Beispiel für ein Dateisystem, das ACLs verwendet.
FS_UNICODE_STORED_ON_DISK	Dateinamen werden als Unicode-Strings gespeichert.

Tabelle 2

Rückgabewerte
1	Die Funktion wurde erfolgreich ausgeführt.
0	Es lag ein Fehler vor.

Tabelle 3

Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
GetCompressedFileSize, GetFileAttributes, SetVolumeLabel

Zugehörige Tipps

• Seriennummer eines Datenträgers ermitteln [Tipp 0059]
• Festplattendaten, Laufwerksdaten auslesen [Tipp 0084]
• Datenträgerbezeichnung lesen und schreiben [Tipp 0153]
• Alternative Datenströme in einer Datei erstellen und lesen [Tipp 0711]