Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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
FileBasicInfoSe debe recuperar o establecer información mínima para el archivo. Se usa para los identificadores de archivo. Vea FILE_BASIC_INFO. |
FileStandardInfoSe 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. |
FileNameInfoSe debe recuperar el nombre de archivo. Se usa para cualquier identificador. Use solo al llamar a . GetFileInformationByHandleEx. Vea FILE_NAME_INFO. |
FileRenameInfoSe debe cambiar el nombre de archivo. Se usa para los identificadores de archivo. Use solo al llamar a . SetFileInformationByHandle. Vea FILE_RENAME_INFO. |
FileDispositionInfoSe debe eliminar el archivo. Se usa para cualquier identificador. Use solo al llamar a . SetFileInformationByHandle. Vea FILE_DISPOSITION_INFO. |
FileAllocationInfoSe 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. |
FileEndOfFileInfoSe debe establecer el final del archivo. Use solo al llamar a . SetFileInformationByHandle. Vea FILE_END_OF_FILE_INFO. |
FileStreamInfoSe 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. |
FileCompressionInfoSe 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. |
FileAttributeTagInfoSe 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. |
FileIdBothDirectoryInfoLos 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. |
FileIdBothDirectoryRestartInfoIdé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. |
FileIoPriorityHintInfoSe debe establecer la información de sugerencia de prioridad. Use solo al llamar a . SetFileInformationByHandle. Vea FILE_IO_PRIORITY_HINT_INFO. |
FileRemoteProtocolInfoSe 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. |
FileFullDirectoryInfoLos 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 |
FileFullDirectoryRestartInfoIdé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 |
FileStorageInfoSe 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 |
FileAlignmentInfoSe 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 |
FileIdInfoSe 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 |
FileIdExtdDirectoryInfoLos 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 |
FileIdExtdDirectoryRestartInfoIdé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 |
MaximumFileInfoByHandleClassEste 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. |