GetDiskSpaceInformationA-Funktion (fileapi.h)

Ruft Speicherplatzinformationen für ein Volume in einem bestimmten Stammpfad ab.

Syntax

HRESULT GetDiskSpaceInformationA(
  LPCSTR                 rootPath,
  DISK_SPACE_INFORMATION *diskSpaceInfo
);

Die Parameter

rootPath

Ein Zeiger auf eine Zeichenfolge, die das Stammverzeichnis des Volumes enthält, das abgefragt werden soll.

Wenn dieser Parameter lautet NULL, verwendet die Funktion den Stamm des aktuellen Datenträgers.

diskSpaceInfo

Eine DISK_SPACE_INFORMATION Struktur, die Informationen zum aktuellen Speicherplatz für das Volume im angegebenen Stammpfad enthält.

Rückgabewert

Gibt zurück S_OK , wenn die Funktion erfolgreich ist, oder ein Wert aus allgemeinen HRESULT-Werten , wenn sie fehlschlägt. Sie können GetLastError für erweiterte Fehlerinformationen aufrufen.

Bemerkungen

Dies rootPath muss ein Stammpfad sein, z C:\ . B. oder D:\, und kein Unterverzeichnis eines Stammpfads.

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows 10 Build 17763 [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server	Windows 10 Server 2019 [Desktop-Apps | UWP-Apps]
Überschrift	fileapi.h (einschließlich Windows.h)
Bibliothek	kernel32.lib
DLL	kernel32.dll

Siehe auch

GetDiskSpaceInformationW-

DISK_SPACE_INFORMATION