GetFileInformationByHandle-Funktion (fileapi.h)

  • Artikel

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

Siehe auch

Dateiverwaltungsfunktionen

GetFileInformationByHandleEx

SetFileInformationByHandle