Compartir a través de

enumeración FILE_INFO_BY_HANDLE_CLASS (minwinbase.h)

  • Artículo

Identifica el tipo de información de archivo que GetFileInformationByHandleEx debe recuperar o SetFileInformationByHandle debe establecer.

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;

Constantes

 
FileBasicInfo
Se debe recuperar o establecer información mínima para el archivo. Se usa para los identificadores de archivo. Vea
FILE_BASIC_INFO.
FileStandardInfo
Se debe recuperar la información extendida del archivo. Se usa para los identificadores de archivo. Use solo al llamar a .
GetFileInformationByHandleEx. Vea
FILE_STANDARD_INFO.
FileNameInfo
Se debe recuperar el nombre de archivo. Se usa para cualquier identificador. Use solo al llamar a .
GetFileInformationByHandleEx. Vea
FILE_NAME_INFO.
FileRenameInfo
Se debe cambiar el nombre de archivo. Se usa para los identificadores de archivo. Use solo al llamar a .
SetFileInformationByHandle. Vea
FILE_RENAME_INFO.
FileDispositionInfo
Se debe eliminar el archivo. Se usa para cualquier identificador. Use solo al llamar a .
SetFileInformationByHandle. Vea
FILE_DISPOSITION_INFO.
FileAllocationInfo
Se debe cambiar la información de asignación de archivos. Se usa para los identificadores de archivo. Use solo al llamar a .
SetFileInformationByHandle. Vea
INFORMACIÓN DE ASIGNACIÓN DE ARCHIVOS.
FileEndOfFileInfo
Se debe establecer el final del archivo. Use solo al llamar a .
SetFileInformationByHandle. Vea
FILE_END_OF_FILE_INFO.
FileStreamInfo
Se debe recuperar la información del flujo de archivos para el archivo especificado. Se usa para cualquier identificador. Use solo al llamar a .
GetFileInformationByHandleEx. Vea
FILE_STREAM_INFO.
FileCompressionInfo
Se debe recuperar la información de compresión de archivos. Se usa para cualquier identificador. Use solo al llamar a .
GetFileInformationByHandleEx. Vea
FILE_COMPRESSION_INFO.
FileAttributeTagInfo
Se debe recuperar la información del atributo de archivo. Se usa para cualquier identificador. Use solo al llamar a .
GetFileInformationByHandleEx. Vea
FILE_ATTRIBUTE_TAG_INFO.
FileIdBothDirectoryInfo
Los archivos del directorio especificado deben recuperarse. Se usa para los identificadores de directorio. Use solo al llamar a .
GetFileInformationByHandleEx. Número
de archivos devueltos para cada llamada a
GetFileInformationByHandleEx depende de
tamaño del búfer que se pasa a la función. Todas las llamadas posteriores a
GetFileInformationByHandleEx en el mismo
handle reanudará la operación de enumeración después de que se devuelva el último archivo. Vea
FILE_ID_BOTH_DIR_INFO.
FileIdBothDirectoryRestartInfo
Idéntico a FileIdBothDirectoryInfo, pero obliga a la operación de enumeración a
empiece de nuevo desde el principio. Vea
FILE_ID_BOTH_DIR_INFO.
FileIoPriorityHintInfo
Se debe establecer la información de sugerencia de prioridad. Use solo al llamar a .
SetFileInformationByHandle. Vea
FILE_IO_PRIORITY_HINT_INFO.
FileRemoteProtocolInfo
Se debe recuperar la información del protocolo remoto de archivos. Use para cualquier identificador. Use solo al llamar a .
GetFileInformationByHandleEx. Vea
FILE_REMOTE_PROTOCOL_INFO.
FileFullDirectoryInfo
Los archivos del directorio especificado deben recuperarse. Se usa para los identificadores de directorio. Use solo al llamar a .
GetFileInformationByHandleEx. Vea
FILE_FULL_DIR_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite antes de Windows 8 y Windows Server 2012
FileFullDirectoryRestartInfo
Idéntico a FileFullDirectoryInfo, pero obliga a la operación de enumeración a
empezar de nuevo desde el principio. Usar solo al llamar a
GetFileInformationByHandleEx. Vea
FILE_FULL_DIR_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite antes de Windows 8 y Windows Server 2012
FileStorageInfo
Se debe recuperar la información de almacenamiento de archivos. Use para cualquier identificador. Usar solo al llamar a
GetFileInformationByHandleEx. Vea
FILE_STORAGE_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite antes de Windows 8 y Windows Server 2012
FileAlignmentInfo
Se debe recuperar la información de alineación de archivos. Use para cualquier identificador. Usar solo al llamar a
GetFileInformationByHandleEx. Vea
FILE_ALIGNMENT_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite antes de Windows 8 y Windows Server 2012
FileIdInfo
Se debe recuperar la información del archivo. Use para cualquier identificador. Usar solo al llamar a
GetFileInformationByHandleEx. Vea
FILE_ID_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite antes de Windows 8 y Windows Server 2012
FileIdExtdDirectoryInfo
Los archivos del directorio especificado deben recuperarse. Se usa para identificadores de directorio. Usar solo al llamar a
GetFileInformationByHandleEx. Vea
FILE_ID_EXTD_DIR_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite antes de Windows 8 y Windows Server 2012
FileIdExtdDirectoryRestartInfo
Idéntico a FileIdExtdDirectoryInfo, pero obliga a la operación de enumeración a
empezar de nuevo desde el principio. Usar solo al llamar a
GetFileInformationByHandleEx. Vea
FILE_ID_EXTD_DIR_INFO.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite antes de Windows 8 y Windows Server 2012
FileDispositionInfoEx
FileRenameInfoEx
MaximumFileInfoByHandleClass
Este valor se usa para la validación. Los valores admitidos son menores que este valor.

Comentarios

Como se indicó en la sección anterior, algunas clases de información de archivo solo son válidas para su uso con GetFileInformationByHandleEx. Otros solo son válidos para su uso con SetFileInformationByHandle. Cuando no se menciona ninguna función, la clase de información es válida con ambas funciones.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Encabezado minwinbase.h (incluye Windows.h)
Redistribuible Windows SDK en Windows Server 2003 y Windows XP.

Consulte también

GetFileInformationByHandleEx

SetFileInformationByHandle