Share via

SHGetDiskFreeSpaceExW-Funktion (shellapi.h)

  • Artikel

Ruft Speicherplatzinformationen für ein Datenträgervolume ab.

Syntax

BOOL SHGetDiskFreeSpaceExW(
  [in]            LPCWSTR        pszDirectoryName,
  [out, optional] ULARGE_INTEGER *pulFreeBytesAvailableToCaller,
  [out, optional] ULARGE_INTEGER *pulTotalNumberOfBytes,
  [out, optional] ULARGE_INTEGER *pulTotalNumberOfFreeBytes
);

Parameter

[in] pszDirectoryName

Typ: LPCTSTR

Eine NULL-Zeichenfolge, die das Volume angibt, für das Größeninformationen abgerufen werden. Dies kann ein Laufwerkbuchstabe, ein UNC-Name oder der Pfad eines Ordners sein. Sie können null nicht verwenden, um das aktuelle Laufwerk darzustellen.

[out, optional] pulFreeBytesAvailableToCaller

Typ: ULARGE_INTEGER*

Zeiger auf einen Wert, der die Anzahl von Bytes auf dem Volume empfängt, das für die aufrufende Anwendung verfügbar ist. Wenn das Betriebssystem Benutzerkontingente implementiert, ist dieser Wert möglicherweise kleiner als die Gesamtzahl der freien Bytes auf dem Volume.

[out, optional] pulTotalNumberOfBytes

Typ: ULARGE_INTEGER*

Zeiger auf einen Wert, der die Gesamtgröße des Volumes in Bytes empfängt.

[out, optional] pulTotalNumberOfFreeBytes

Typ: ULARGE_INTEGER*

Zeiger auf einen Wert, der die Anzahl der Bytes des freien Speicherplatzes auf dem Volume empfängt.

Rückgabewert

Typ: BOOL

Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE .

Hinweise

Die ähnlich benannte Funktion SHGetDiskFreeSpace ist lediglich ein Alias für SHGetDiskFreeSpaceEx. Wenn Sie SHGetDiskFreeSpace aufrufen, rufen Sie diese Funktion tatsächlich auf.

Diese Funktion ruft die GetDiskFreeSpaceEx-Funktion auf, wenn sie unter dem Betriebssystem verfügbar ist. Wenn GetDiskFreeSpaceEx nicht verfügbar ist, wird es emuliert, indem die GetDiskFreeSpace-Funktion aufgerufen und die Rückgabewerte bearbeitet werden. Weitere Informationen finden Sie in der Dokumentation zu GetDiskFreeSpaceEx.

Hinweis

Der shellapi.h-Header definiert SHGetDiskFreeSpaceEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shellapi.h
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

GetDiskFreeSpaceEx

SHGetDiskFreeSpace