GetFileSizeEx-Funktion (fileapi.h)
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 |