enumerazione FILE_INFO_BY_HANDLE_CLASS (minwinbase.h)

Identifica il tipo di informazioni sul file che deve essere recuperato Da GetFileInformationByHandleEx o SetFileInformationByHandle deve essere impostato.

Sintassi

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;

Costanti

FileBasicInfo Le informazioni minime per il file devono essere recuperate o impostate. Usato per gli handle di file. Vedere FILE_BASIC_INFO.
FileStandardInfo Le informazioni estese per il file devono essere recuperate. Usato per gli handle di file. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_STANDARD_INFO.
FileNameInfo Il nome del file deve essere recuperato. Utilizzato per qualsiasi handle. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_NAME_INFO.
FileRenameInfo Il nome del file deve essere modificato. Usato per gli handle di file. Usare solo quando si chiama SetFileInformationByHandle. Vedere FILE_RENAME_INFO.
FileDispositionInfo Il file deve essere eliminato. Utilizzato per qualsiasi handle. Usare solo quando si chiama SetFileInformationByHandle. Vedere FILE_DISPOSITION_INFO.
FileAllocationInfo Le informazioni sull'allocazione dei file devono essere modificate. Usato per gli handle di file. Usare solo quando si chiama SetFileInformationByHandle. Vedere INFORMAZIONI SULL'ALLOCAZIONE FILE.
FileEndOfFileInfo La fine del file deve essere impostata. Usare solo quando si chiama SetFileInformationByHandle. Vedere FILE_END_OF_FILE_INFO.
FileStreamInfo Le informazioni sul flusso di file per il file specificato devono essere recuperate. Utilizzato per qualsiasi handle. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_STREAM_INFO.
FileCompressionInfo Le informazioni sulla compressione dei file devono essere recuperate. Utilizzato per qualsiasi handle. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_COMPRESSION_INFO.
FileAttributeTagInfo Le informazioni sull'attributo file devono essere recuperate. Utilizzato per qualsiasi handle. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_ATTRIBUTE_TAG_INFO.
FileIdBothDirectoryInfo I file nella directory specificata devono essere recuperati. Usato per gli handle di directory. Usare solo quando si chiama GetFileInformationByHandleEx. Numero di file restituiti per ogni chiamata a GetFileInformationByHandleEx dipende da dimensioni del buffer passato alla funzione. Tutte le chiamate successive a GetFileInformationByHandleEx sullo stesso handle riprenderà l'operazione di enumerazione dopo la restituzione dell'ultimo file. Vedere FILE_ID_BOTH_DIR_INFO.
FileIdBothDirectoryRestartInfo Identico a FileIdBothDirectoryInfo, ma forza l'operazione di enumerazione in ricominciare dall'inizio. Vedere FILE_ID_BOTH_DIR_INFO.
FileIoPriorityHintInfo È necessario impostare le informazioni sui suggerimenti per la priorità. Usare solo quando si chiama SetFileInformationByHandle. Vedere FILE_IO_PRIORITY_HINT_INFO.
FileRemoteProtocolInfo È necessario recuperare le informazioni sul protocollo remoto dei file. Usare per qualsiasi handle. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_REMOTE_PROTOCOL_INFO.
FileFullDirectoryInfo I file nella directory specificata devono essere recuperati. Usato per gli handle di directory. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_FULL_DIR_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato prima di Windows 8 e Windows Server 2012
FileFullDirectoryRestartInfo Identico a FileFullDirectoryInfo, ma forza l'operazione di enumerazione in ricominciare dall'inizio. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_FULL_DIR_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato prima di Windows 8 e Windows Server 2012
FileStorageInfo Le informazioni sull'archiviazione file devono essere recuperate. Usare per qualsiasi handle. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_STORAGE_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato prima di Windows 8 e Windows Server 2012
FileAlignmentInfo Le informazioni sull'allineamento dei file devono essere recuperate. Usare per qualsiasi handle. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_ALIGNMENT_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato prima di Windows 8 e Windows Server 2012
FileIdInfo Le informazioni sui file devono essere recuperate. Usare per qualsiasi handle. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_ID_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato prima di Windows 8 e Windows Server 2012
FileIdExtdDirectoryInfo I file nella directory specificata devono essere recuperati. Usato per gli handle di directory. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_ID_EXTD_DIR_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato prima di Windows 8 e Windows Server 2012
FileIdExtdDirectoryRestartInfo Identico a FileIdExtdDirectoryInfo, ma forza l'operazione di enumerazione in ricominciare dall'inizio. Usare solo quando si chiama GetFileInformationByHandleEx. Vedere FILE_ID_EXTD_DIR_INFO. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato prima di Windows 8 e Windows Server 2012
FileDispositionInfoEx
FileRenameInfoEx
MaximumFileInfoByHandleClass Questo valore viene usato per la convalida. I valori supportati sono minori di questo valore.

Commenti

Come indicato nella sezione precedente, alcune classi di informazioni sui file sono valide solo per l'uso con GetFileInformationByHandleEx. Altri sono validi solo per l'uso con SetFileInformationByHandle. Se nessuna delle due funzioni è menzionata, la classe di informazioni è valida con entrambe le funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 [app desktop | App UWP]
Intestazione	minwinbase.h (include Windows.h)
Componente ridistribuibile	Windows SDK in Windows Server 2003 e Windows XP.

Vedi anche

GetFileInformationByHandleEx

SetFileInformationByHandle