Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Identifica o tipo de informações de arquivo que GetFileInformationByHandleEx deve recuperar ou SetFileInformationByHandle deve definir.
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
FileBasicInfoInformações mínimas para o arquivo devem ser recuperadas ou definidas. Usado para identificadores de arquivo. Consulte FILE_BASIC_INFO. |
FileStandardInfoInformações estendidas para o arquivo devem ser recuperadas. Usado para identificadores de arquivo. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_STANDARD_INFO. |
FileNameInfoO nome do arquivo deve ser recuperado. Usado para todos os identificadores. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_NAME_INFO. |
FileRenameInfoO nome do arquivo deve ser alterado. Usado para identificadores de arquivo. Usar somente ao chamar SetFileInformationByHandle. Consulte FILE_RENAME_INFO. |
FileDispositionInfoO arquivo deve ser excluído. Usado para todos os identificadores. Usar somente ao chamar SetFileInformationByHandle. Consulte FILE_DISPOSITION_INFO. |
FileAllocationInfoAs informações de alocação de arquivo devem ser alteradas. Usado para identificadores de arquivo. Usar somente ao chamar SetFileInformationByHandle. Consulte INFORMAÇÕES DE ALOCAÇÃO DE ARQUIVO. |
FileEndOfFileInfoO final do arquivo deve ser definido. Usar somente ao chamar SetFileInformationByHandle. Consulte FILE_END_OF_FILE_INFO. |
FileStreamInfoAs informações de fluxo de arquivo para o arquivo especificado devem ser recuperadas. Usado para todos os identificadores. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_STREAM_INFO. |
FileCompressionInfoAs informações de compactação de arquivo devem ser recuperadas. Usado para todos os identificadores. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_COMPRESSION_INFO. |
FileAttributeTagInfoAs informações do atributo de arquivo devem ser recuperadas. Usado para todos os identificadores. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_ATTRIBUTE_TAG_INFO. |
FileIdBothDirectoryInfoOs arquivos no diretório especificado devem ser recuperados. Usado para identificadores de diretório. Usar somente ao chamar GetFileInformationByHandleEx. O número de arquivos retornados para cada chamada para GetFileInformationByHandleEx depende de o tamanho do buffer que é passado para a função . Todas as chamadas subsequentes para GetFileInformationByHandleEx no mesmo handle retomará a operação de enumeração depois que o último arquivo for retornado. Consulte FILE_ID_BOTH_DIR_INFO. |
FileIdBothDirectoryRestartInfoIdêntico a FileIdBothDirectoryInfo, mas força a operação de enumeração a comece novamente desde o início. Consulte FILE_ID_BOTH_DIR_INFO. |
FileIoPriorityHintInfoInformações de dica de prioridade devem ser definidas. Usar somente ao chamar SetFileInformationByHandle. Consulte FILE_IO_PRIORITY_HINT_INFO. |
FileRemoteProtocolInfoAs informações de protocolo remoto do arquivo devem ser recuperadas. Use para qualquer identificador. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_REMOTE_PROTOCOL_INFO. |
FileFullDirectoryInfoOs arquivos no diretório especificado devem ser recuperados. Usado para identificadores de diretório. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_FULL_DIR_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor antes de Windows 8 e Windows Server 2012 |
FileFullDirectoryRestartInfoIdêntico a FileFullDirectoryInfo, mas força a operação de enumeração a comece novamente desde o início. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_FULL_DIR_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor antes de Windows 8 e Windows Server 2012 |
FileStorageInfoAs informações de armazenamento de arquivos devem ser recuperadas. Use para qualquer identificador. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_STORAGE_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor antes de Windows 8 e Windows Server 2012 |
FileAlignmentInfoAs informações de alinhamento do arquivo devem ser recuperadas. Use para qualquer identificador. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_ALIGNMENT_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor antes de Windows 8 e Windows Server 2012 |
FileIdInfoAs informações do arquivo devem ser recuperadas. Use para qualquer identificador. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_ID_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor antes de Windows 8 e Windows Server 2012 |
FileIdExtdDirectoryInfoOs arquivos no diretório especificado devem ser recuperados. Usado para identificadores de diretório. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_ID_EXTD_DIR_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor antes de Windows 8 e Windows Server 2012 |
FileIdExtdDirectoryRestartInfoIdêntico a FileIdExtdDirectoryInfo, mas força a operação de enumeração a comece novamente desde o início. Usar somente ao chamar GetFileInformationByHandleEx. Consulte FILE_ID_EXTD_DIR_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor antes de Windows 8 e Windows Server 2012 |
FileDispositionInfoEx |
FileRenameInfoEx |
MaximumFileInfoByHandleClassEsse valor é usado para validação. Os valores com suporte são menores que esse valor. |
Comentários
Conforme observado na seção anterior, algumas classes de informações de arquivo são válidas apenas para uso com GetFileInformationByHandleEx. Outros são válidos somente para uso com SetFileInformationByHandle. Quando nenhuma das funções é mencionada, a classe de informações é válida com ambas as funções.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Cabeçalho | minwinbase.h (inclua Windows.h) |
| Redistribuível | SDK do Windows no Windows Server 2003 e no Windows XP. |