structure FILE_FS_ATTRIBUTE_INFORMATION (ntifs.h)

La structure FILE_FS_ATTRIBUTE_INFORMATION est utilisée pour interroger les informations d’attribut pour un système de fichiers.

Syntaxe

typedef struct _FILE_FS_ATTRIBUTE_INFORMATION {
  ULONG FileSystemAttributes;
  LONG  MaximumComponentNameLength;
  ULONG FileSystemNameLength;
  WCHAR FileSystemName[1];
} FILE_FS_ATTRIBUTE_INFORMATION, *PFILE_FS_ATTRIBUTE_INFORMATION;

Membres

FileSystemAttributes

Masque de bits des indicateurs spécifiant des attributs du système de fichiers spécifié, en tant que combinaison compatible des indicateurs suivants.

MaximumComponentNameLength

Longueur maximale du composant de nom de fichier prise en charge par le système de fichiers spécifié, en caractères. Un composant de nom de fichier est cette partie d’un nom de fichier entre les caractères séparateurs de chemin d’accès (tels que les barres obliques inverses).

FileSystemNameLength

Longueur, en octets, du nom du système de fichiers. La valeur de ce champ doit être supérieure à zéro.

FileSystemName[1]

Champ Unicode de longueur variable contenant le nom du système de fichiers. Ce champ n’est pas terminé par null et doit être géré sous la forme d’une séquence d'FileSystemNameLength octets.

Remarques

Ces informations peuvent être interrogées de l’une des manières suivantes :

• Appelez FltQueryVolumeInformation ou ZwQueryVolumeInformationFile, en passant FileFsAttributeInformation comme valeur de FileInformationClass et en passant une mémoire tampon FILE_FS_ATTRIBUTE_INFORMATION-structurée FILE_FS_ATTRIBUTE_INFORMATION-structurée comme valeur de FileInformation.

  • Remarque : sur CSVFS, FileFsAttributeInformation retourne FILE_FS_ATTRIBUTE_INFORMATION pour le système de fichiers CSVFS. Si vous souhaitez interroger FileFsAttributeInformation pour que le système de fichiers CSVFS soit superposé, vous devez utiliser FSCTL_CSV_QUERY_DOWN_LEVEL_FILE_SYSTEM_CHARACTERISTICS.

• Créez un IRP avec le code de fonction principal IRP_MJ_QUERY_VOLUME_INFORMATION.

Aucun droit d’accès spécifique n’est requis pour interroger ces informations. Ainsi, ces informations sont disponibles tant que le volume est accessible via un handle ouvert au volume lui-même, ou à un fichier ou répertoire sur le volume.

La taille de la mémoire tampon passée dans le paramètre FileInformation à FltQueryVolumeInformation ou ZwQueryVolumeInformationFile doit être au moins . Étant donné qu’une longueur maximale du nom du système de fichiers ne peut pas être supposée (pratiquement, la limite est de 2^31 points de caractères), un deuxième appel à l’une de ces routines sera nécessaire une fois FileSystemNameLength est connu.

Cette structure doit être alignée sur une limite LONG (4 octets).

Exigences

Voir aussi

de liste de contrôle d’accès

FltQueryVolumeInformation

IRP_MJ_QUERY_VOLUME_INFORMATION

ZwQueryVolumeInformationFile