FILE_INFO_BY_HANDLE_CLASS-Enumeration (minwinbase.h)

Hiermit wird der Typ der Dateiinformationen identifiziert, die GetFileInformationByHandleEx abrufen oder SetFileInformationByHandle festlegen soll.

Syntax

typedef enum _FILE_INFO_BY_HANDLE_CLASS {
  FileBasicInfo,
  FileStandardInfo,
  FileNameInfo,
  FileRenameInfo,
  FileDispositionInfo,
  FileAllocationInfo,
  FileEndOfFileInfo,
  FileStreamInfo,
  FileCompressionInfo,
  FileAttributeTagInfo,
  FileIdBothDirectoryInfo,
  FileIdBothDirectoryRestartInfo,
  FileIoPriorityHintInfo,
  FileRemoteProtocolInfo,
  FileFullDirectoryInfo,
  FileFullDirectoryRestartInfo,
  FileStorageInfo,
  FileAlignmentInfo,
  FileIdInfo,
  FileIdExtdDirectoryInfo,
  FileIdExtdDirectoryRestartInfo,
  FileDispositionInfoEx,
  FileRenameInfoEx,
  FileCaseSensitiveInfo,
  FileNormalizedNameInfo,
  MaximumFileInfoByHandleClass
} FILE_INFO_BY_HANDLE_CLASS, *PFILE_INFO_BY_HANDLE_CLASS;

Konstanten

FileBasicInfo Es sollten minimale Informationen für die Datei abgerufen oder festgelegt werden. Wird für Dateihandles verwendet. Siehe FILE_BASIC_INFO.
FileStandardInfo Erweiterte Informationen für die Datei sollten abgerufen werden. Wird für Dateihandles verwendet. Verwenden Sie nur beim Aufrufen von GetFileInformationByHandleEx. Siehe FILE_STANDARD_INFO.
FileNameInfo Der Dateiname sollte abgerufen werden. Wird für beliebige Handles verwendet. Verwenden Sie nur beim Aufrufen von GetFileInformationByHandleEx. Siehe FILE_NAME_INFO.
FileRenameInfo Der Dateiname sollte geändert werden. Wird für Dateihandles verwendet. Verwenden Sie nur beim Aufrufen von SetFileInformationByHandle. Siehe FILE_RENAME_INFO.
FileDispositionInfo Die Datei sollte gelöscht werden. Wird für beliebige Handles verwendet. Verwenden Sie nur beim Aufrufen von SetFileInformationByHandle. Siehe FILE_DISPOSITION_INFO.
FileAllocationInfo Die Dateizuordnungsinformationen sollten geändert werden. Wird für Dateihandles verwendet. Verwenden Sie nur beim Aufrufen von SetFileInformationByHandle. Siehe DATEIZUORDNUNGSINFORMATIONEN.
FileEndOfFileInfo Das Ende der Datei sollte festgelegt werden. Verwenden Sie nur beim Aufrufen von SetFileInformationByHandle. Siehe FILE_END_OF_FILE_INFO.
FileStreamInfo Dateidatenstrominformationen für die angegebene Datei sollten abgerufen werden. Wird für beliebige Handles verwendet. Verwenden Sie nur beim Aufrufen von GetFileInformationByHandleEx. Siehe FILE_STREAM_INFO.
FileCompressionInfo Dateikomprimierungsinformationen sollten abgerufen werden. Wird für beliebige Handles verwendet. Verwenden Sie nur beim Aufrufen von GetFileInformationByHandleEx. Siehe FILE_COMPRESSION_INFO.
FileAttributeTagInfo Dateiattributeinformationen sollten abgerufen werden. Wird für beliebige Handles verwendet. Verwenden Sie nur beim Aufrufen von GetFileInformationByHandleEx. Siehe FILE_ATTRIBUTE_TAG_INFO.
FileIdBothDirectoryInfo Dateien im angegebenen Verzeichnis sollten abgerufen werden. Wird für Verzeichnishandles verwendet. Verwenden Sie nur beim Aufrufen von GetFileInformationByHandleEx. Die Zahl von Dateien, die für jeden Aufruf von zurückgegeben werden GetFileInformationByHandleEx hängt von ab die Größe des Puffers, der an die Funktion übergeben wird. Alle nachfolgenden Aufrufe von GetFileInformationByHandleEx auf demselben handle setzt den Enumerationsvorgang wieder her, nachdem die letzte Datei zurückgegeben wurde. Siehe FILE_ID_BOTH_DIR_INFO.
FileIdBothDirectoryRestartInfo Identisch mit FileIdBothDirectoryInfo, erzwingt jedoch den Enumerationsvorgang beginnen Sie erneut von Anfang an. Siehe FILE_ID_BOTH_DIR_INFO.
FileIoPriorityHintInfo Prioritätshinweisinformationen sollten festgelegt werden. Verwenden Sie nur beim Aufrufen von SetFileInformationByHandle. Siehe FILE_IO_PRIORITY_HINT_INFO.
FileRemoteProtocolInfo Datei-Remoteprotokollinformationen sollten abgerufen werden. Verwenden Sie für alle Handles. Verwenden Sie nur beim Aufrufen von GetFileInformationByHandleEx. Siehe FILE_REMOTE_PROTOCOL_INFO.
FileFullDirectoryInfo Dateien im angegebenen Verzeichnis sollten abgerufen werden. Wird für Verzeichnishandles verwendet. Verwenden Sie nur beim Aufrufen von GetFileInformationByHandleEx. Siehe FILE_FULL_DIR_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
FileFullDirectoryRestartInfo Identisch mit FileFullDirectoryInfo, erzwingt jedoch den Enumerationsvorgang beginnen Sie erneut von Anfang an. Nur beim Aufrufen verwenden GetFileInformationByHandleEx. Siehe FILE_FULL_DIR_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
FileStorageInfo Dateispeicherinformationen sollten abgerufen werden. Verwenden Sie für beliebige Handles. Nur beim Aufrufen verwenden GetFileInformationByHandleEx. Siehe FILE_STORAGE_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
FileAlignmentInfo Dateiausrichtungsinformationen sollten abgerufen werden. Verwenden Sie für beliebige Handles. Nur beim Aufrufen verwenden GetFileInformationByHandleEx. Siehe FILE_ALIGNMENT_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
FileIdInfo Dateiinformationen sollten abgerufen werden. Verwenden Sie für beliebige Handles. Nur beim Aufrufen verwenden GetFileInformationByHandleEx. Siehe FILE_ID_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
FileIdExtdDirectoryInfo Dateien im angegebenen Verzeichnis sollten abgerufen werden. Wird für Verzeichnishandles verwendet. Nur beim Aufrufen verwenden GetFileInformationByHandleEx. Siehe FILE_ID_EXTD_DIR_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
FileIdExtdDirectoryRestartInfo Identisch mit FileIdExtdDirectoryInfo, erzwingt jedoch den Enumerationsvorgang beginnen Sie erneut von Anfang an. Nur beim Aufrufen verwenden GetFileInformationByHandleEx. Siehe FILE_ID_EXTD_DIR_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
FileDispositionInfoEx
FileRenameInfoEx
MaximumFileInfoByHandleClass Dieser Wert wird für die Validierung verwendet. Unterstützte Werte sind kleiner als dieser Wert.

Hinweise

Wie im vorherigen Abschnitt erwähnt, sind einige Dateiinformationsklassen nur für die Verwendung mit GetFileInformationByHandleEx gültig. Andere sind nur für die Verwendung mit SetFileInformationByHandle gültig. Wenn keine Funktion erwähnt wird, ist die Informationsklasse für beide Funktionen gültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Kopfzeile	minwinbase.h (einschließlich Windows.h)
Verteilbare Komponente	Windows SDK unter Windows Server 2003 und Windows XP.

Weitere Informationen

GetFileInformationByHandleEx

SetFileInformationByHandle