GetFileSizeEx-Funktion (fileapi.h)

  • Artikel

Ruft die Größe der angegebenen Datei ab.

Syntax

BOOL GetFileSizeEx(
  [in]  HANDLE         hFile,
  [out] PLARGE_INTEGER lpFileSize
);

Parameter

[in] hFile

Ein Handle zur Datei. Das Handle muss mit dem Zugriffsrecht FILE_READ_ATTRIBUTES oder einer entsprechenden Berechtigung erstellt worden sein, oder der Aufrufer muss über ausreichende Berechtigungen für das Verzeichnis verfügen, das die Datei enthält. Weitere Informationen finden Sie unter Dateisicherheit und Zugriffsrechte.

[out] lpFileSize

Ein Zeiger auf eine LARGE_INTEGER Struktur, die die Dateigröße in Bytes empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Transaktionierte Vorgänge: Wenn eine Transaktion an das Dateihandle gebunden ist, gibt die Funktion Informationen für die isolierte Dateiansicht zurück.

Windows Store-Apps: GetFileSizeEx wird nicht unterstützt. Verwenden Sie GetFileInformationByHandleEx.

Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie Unterstützt
SMB 3.0-Protokoll (Server Message Block) Ja
SMB 3.0 Transparent Failover (TFO) Ja
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) Ja
Dateisystem mit freigegebenen Clustervolumes (CsvFS) Ja
Robustes Dateisystem (Resilient File System, ReFS) Ja

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile fileapi.h (Einschließen von Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Dateiverwaltungsfunktionen

LARGE_INTEGER