Compartilhar via

enumeração FILE_INFO_BY_HANDLE_CLASS (minwinbase.h)

  • Artigo

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

 
FileBasicInfo
Informações mínimas para o arquivo devem ser recuperadas ou definidas. Usado para identificadores de arquivo. Consulte
FILE_BASIC_INFO.
FileStandardInfo
Informações estendidas para o arquivo devem ser recuperadas. Usado para identificadores de arquivo. Usar somente ao chamar
GetFileInformationByHandleEx. Consulte
FILE_STANDARD_INFO.
FileNameInfo
O nome do arquivo deve ser recuperado. Usado para todos os identificadores. Usar somente ao chamar
GetFileInformationByHandleEx. Consulte
FILE_NAME_INFO.
FileRenameInfo
O nome do arquivo deve ser alterado. Usado para identificadores de arquivo. Usar somente ao chamar
SetFileInformationByHandle. Consulte
FILE_RENAME_INFO.
FileDispositionInfo
O arquivo deve ser excluído. Usado para todos os identificadores. Usar somente ao chamar
SetFileInformationByHandle. Consulte
FILE_DISPOSITION_INFO.
FileAllocationInfo
As 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.
FileEndOfFileInfo
O final do arquivo deve ser definido. Usar somente ao chamar
SetFileInformationByHandle. Consulte
FILE_END_OF_FILE_INFO.
FileStreamInfo
As 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.
FileCompressionInfo
As informações de compactação de arquivo devem ser recuperadas. Usado para todos os identificadores. Usar somente ao chamar
GetFileInformationByHandleEx. Consulte
FILE_COMPRESSION_INFO.
FileAttributeTagInfo
As informações do atributo de arquivo devem ser recuperadas. Usado para todos os identificadores. Usar somente ao chamar
GetFileInformationByHandleEx. Consulte
FILE_ATTRIBUTE_TAG_INFO.
FileIdBothDirectoryInfo
Os 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.
FileIdBothDirectoryRestartInfo
Idê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.
FileIoPriorityHintInfo
Informações de dica de prioridade devem ser definidas. Usar somente ao chamar
SetFileInformationByHandle. Consulte
FILE_IO_PRIORITY_HINT_INFO.
FileRemoteProtocolInfo
As informações de protocolo remoto do arquivo devem ser recuperadas. Use para qualquer identificador. Usar somente ao chamar
GetFileInformationByHandleEx. Consulte
FILE_REMOTE_PROTOCOL_INFO.
FileFullDirectoryInfo
Os 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
FileFullDirectoryRestartInfo
Idê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
FileStorageInfo
As 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
FileAlignmentInfo
As 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
FileIdInfo
As 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
FileIdExtdDirectoryInfo
Os 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
FileIdExtdDirectoryRestartInfo
Idê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
MaximumFileInfoByHandleClass
Esse 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.

Confira também

GetFileInformationByHandleEx

SetFileInformationByHandle