GetFileInformationByHandle-Funktion (fileapi.h)
Ruft Dateiinformationen für die angegebene Datei ab.
Eine erweiterte Version dieser Funktion finden Sie unter GetFileInformationByHandleEx.
Informationen zum Festlegen von Dateiinformationen mithilfe eines Dateihandles finden Sie unter SetFileInformationByHandle.
Syntax
BOOL GetFileInformationByHandle(
[in] HANDLE hFile,
[out] LPBY_HANDLE_FILE_INFORMATION lpFileInformation
);
Parameter
[in] hFile
Ein Handle für die Datei, die die abzurufenden Informationen enthält.
Dieses Handle sollte kein Pipehandle sein.
[out] lpFileInformation
Ein Zeiger auf eine BY_HANDLE_FILE_INFORMATION Struktur, die die Dateiinformationen empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich null, und dateiinformationsdaten sind im Puffer enthalten, auf den der lpFileInformation-Parameter verweist.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Abhängig von den zugrunde liegenden Netzwerkfeatures des Betriebssystems und dem Servertyp, mit dem verbunden ist, schlägt die GetFileInformationByHandle-Funktion möglicherweise fehl, gibt Teilinformationen oder vollständige Informationen für die angegebene Datei zurück.
Sie können die in der BY_HANDLE_FILE_INFORMATION-Struktur zurückgegebenen Member VolumeSerialNumber und FileIndex vergleichen, um zu ermitteln, ob zwei Pfade demselben Ziel zugeordnet sind. Sie können beispielsweise zwei Dateipfade vergleichen und ermitteln, ob sie demselben Verzeichnis zugeordnet sind.
IIn 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 |
Transaktionierte Vorgänge
Wenn zum Zeitpunkt des Aufrufs eine Transaktion an den Thread gebunden ist, gibt die Funktion die komprimierte Dateigröße der isolierten Dateiansicht zurück. Weitere Informationen finden Sie unter Informationen zu Transaktions-NTFS.Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | fileapi.h (Einschließen von Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |