перечисление FILE_INFO_BY_HANDLE_CLASS (minwinbase.h)

  • Статья

Определяет тип сведений о файлах, которые должен получить GetFileInformationByHandleEx или setFileInformationByHandle .

Синтаксис

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;

Константы

 
FileBasicInfo
Необходимо получить или задать минимальные сведения для файла. Используется для дескрипторов файлов. См.
FILE_BASIC_INFO.
FileStandardInfo
Необходимо получить расширенные сведения о файле. Используется для дескрипторов файлов. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_STANDARD_INFO.
FileNameInfo
Необходимо получить имя файла. Используется для любых дескрипторов. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_NAME_INFO.
FileRenameInfo
Имя файла должно быть изменено. Используется для дескрипторов файлов. Использовать только при вызове
SetFileInformationByHandle. См.
FILE_RENAME_INFO.
FileDispositionInfo
Файл должен быть удален. Используется для любых дескрипторов. Использовать только при вызове
SetFileInformationByHandle. См.
FILE_DISPOSITION_INFO.
FileAllocationInfo
Сведения о выделении файлов должны быть изменены. Используется для дескрипторов файлов. Использовать только при вызове
SetFileInformationByHandle. См.
СВЕДЕНИЯ О ВЫДЕЛЕНИИ ФАЙЛОВ.
FileEndOfFileInfo
Должен быть задан конец файла. Использовать только при вызове
SetFileInformationByHandle. См.
FILE_END_OF_FILE_INFO.
FileStreamInfo
Необходимо получить сведения о потоке файлов для указанного файла. Используется для любых дескрипторов. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_STREAM_INFO.
FileCompressionInfo
Необходимо получить сведения о сжатии файлов. Используется для любых дескрипторов. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_COMPRESSION_INFO.
FileAttributeTagInfo
Необходимо получить сведения об атрибуте файла. Используется для любых дескрипторов. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_ATTRIBUTE_TAG_INFO.
FileIdBothDirectoryInfo
Файлы в указанном каталоге должны быть извлечены. Используется для дескрипторов каталога. Использовать только при вызове
GetFileInformationByHandleEx. Число
файлов, возвращаемых для каждого вызова
GetFileInformationByHandleEx зависит от
размер буфера, передаваемого в функцию. Все последующие вызовы
GetFileInformationByHandleEx на том же
Дескриптор возобновит операцию перечисления после возврата последнего файла. См.
FILE_ID_BOTH_DIR_INFO.
FileIdBothDirectoryRestartInfo
Идентично FileIdBothDirectoryInfo, но при принудительном выполнении операции перечисления выполняется
начать заново с самого начала. См.
FILE_ID_BOTH_DIR_INFO.
FileIoPriorityHintInfo
Необходимо задать сведения о подсказке приоритета. Использовать только при вызове
SetFileInformationByHandle. См.
FILE_IO_PRIORITY_HINT_INFO.
FileRemoteProtocolInfo
Необходимо получить сведения об удаленном протоколе файла. Используется для любых дескрипторов. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_REMOTE_PROTOCOL_INFO.
FileFullDirectoryInfo
Файлы в указанном каталоге должны быть извлечены. Используется для дескрипторов каталога. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_FULL_DIR_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows 8 и Windows Server 2012
FileFullDirectoryRestartInfo
Идентично FileFullDirectoryInfo, но при принудительном выполнении операции перечисления выполняется
начать заново с самого начала. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_FULL_DIR_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows 8 и Windows Server 2012
FileStorageInfo
Необходимо получить сведения о хранилище файлов. Используется для любых дескрипторов. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_STORAGE_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows 8 и Windows Server 2012
FileAlignmentInfo
Необходимо получить сведения о выравнивании файлов. Используется для любых дескрипторов. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_ALIGNMENT_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows 8 и Windows Server 2012
FileIdInfo
Необходимо получить сведения о файле. Используется для любых дескрипторов. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_ID_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows 8 и Windows Server 2012
FileIdExtdDirectoryInfo
Файлы в указанном каталоге должны быть извлечены. Используется для дескрипторов каталога. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_ID_EXTD_DIR_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows 8 и Windows Server 2012
FileIdExtdDirectoryRestartInfo
Идентично FileIdExtdDirectoryInfo, но при принудительном выполнении операции перечисления выполняется
начать заново с самого начала. Использовать только при вызове
GetFileInformationByHandleEx. См.
FILE_ID_EXTD_DIR_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows 8 и Windows Server 2012
FileDispositionInfoEx
FileRenameInfoEx
MaximumFileInfoByHandleClass
Это значение используется для проверки. Поддерживаемые значения меньше этого значения.

Комментарии

Как отмечалось в предыдущем разделе, некоторые классы сведений о файлах допустимы только для использования с GetFileInformationByHandleEx. Другие допустимы только для использования с SetFileInformationByHandle. Если ни одно из функций не упоминается, информационный класс является допустимым для обеих функций.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Верхняя часть minwinbase.h (включая Windows.h)
Распространяемые компоненты Windows SDK в Windows Server 2003 и Windows XP.

См. также раздел

GetFileInformationByHandleEx

SetFileInformationByHandle