Freigeben über

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 mit Null beendete Zeichenfolge, die das Volume angibt, für das Größeninformationen abgerufen werden. Dies kann ein Laufwerkbuchstaben, 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*

Zeigen Sie auf einen Wert, der die Anzahl der Bytes auf dem Volume empfängt, das für die aufrufende Anwendung verfügbar ist. Wenn das Betriebssystem Kontingente pro Benutzer implementiert, ist dieser Wert möglicherweise kleiner als die Gesamtanzahl der freien Bytes auf dem Volume.

[out, optional] pulTotalNumberOfBytes

Typ: ULARGE_INTEGER*

Zeigen Sie auf einen Wert, der die Gesamtgröße des Volumes in Byte empfängt.

[out, optional] pulTotalNumberOfFreeBytes

Typ: ULARGE_INTEGER*

Zeigen Sie 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 dies erfolgreich ist, andernfalls FALSE.

Bemerkungen

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 auf dem Betriebssystem verfügbar ist. Wenn GetDiskFreeSpaceEx- nicht verfügbar ist, wird sie emuliert, indem die GetDiskFreeSpace--Funktion aufgerufen und die Rückgabewerte manipuliert werden. Weitere Informationen finden Sie in der Dokumentation zu GetDiskFreeSpaceEx.

Anmerkung

Der shellapi.h-Header definiert SHGetDiskFreeSpaceEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client- Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- shellapi.h
Library Shell32.lib
DLL- Shell32.dll (Version 5.0 oder höher)

Siehe auch

GetDiskFreeSpaceEx-

SHGetDiskFreeSpace-