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

Siehe auch

GetDiskSpaceInformationW-

DISK_SPACE_INFORMATION