structure FILE_FS_OBJECTID_INFORMATION (ntddk.h)
La structure FILE_FS_OBJECTID_INFORMATION est utilisée pour interroger ou définir l’ID d’objet d’un volume de système de fichiers.
Syntaxe
typedef struct _FILE_FS_OBJECTID_INFORMATION {
UCHAR ObjectId[16];
UCHAR ExtendedInfo[48];
} FILE_FS_OBJECTID_INFORMATION, *PFILE_FS_OBJECTID_INFORMATION;
Membres
ObjectId[16]
GUID de 16 octets qui identifie le volume du système de fichiers sur le disque.
ExtendedInfo[48]
Valeur de 48 octets contenant des informations facultatives et supplémentaires définies par l’appelant sur le volume du système de fichiers. La signification de ces informations étendues est opaque pour le système de fichiers.
Remarques
Ces informations peuvent être interrogées de l’une des manières suivantes :
- Appelez FltQueryVolumeInformation ou ZwQueryVolumeInformationFile, en transmettant FileFsObjectIdInformation comme valeur de FileInformationClass et en passant une mémoire tampon FILE_FS_OBJECTID_INFORMATION structurée par l’appelant comme valeur de FileInformation.
- 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. Par conséquent, ces informations sont disponibles tant que le volume est accessible via un handle ouvert au volume lui-même ou à un fichier ou un répertoire sur le volume.
Ces informations peuvent être définies de l’une des manières suivantes :
- Appelez FltSetVolumeInformation ou ZwSetVolumeInformationFile, en transmettant FileFsObjectIdInformation comme valeur de FileInformationClass et en passant une mémoire tampon FILE_FS_OBJECTID_INFORMATION structurée par l’appelant comme valeur de FileInformation.
- Créez un IRP avec le code de fonction principal IRP_MJ_SET_VOLUME_INFORMATION.
FILE_WRITE_DATA’accès au volume est requis pour définir ces informations.
La prise en charge des ID d’objet de volume est spécifique au système de fichiers. Dans NTFS, les ID d’objet de volume sont largement utilisés par le service de suivi des liens distribués.
Il est important de noter que l’ID d’objet de volume n’est pas le même que le GUID de volume. L’ID d’objet de volume est affecté au volume du système de fichiers par le système de fichiers. Le GUID de volume, ou nom de volume unique, est indépendant du système de fichiers ; il est affecté au volume de stockage sous-jacent par le Gestionnaire de montage de volume.
Pour obtenir le GUID de volume d’un volume, utilisez la fonction Win32 GetVolumeNameForVolumeMountPointW ou la routine FltGetVolumeGuidName .
La taille de la mémoire tampon passée dans le paramètre FileInformation à FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile ou ZwSetVolumeInformationFile doit être d’au moins sizeof (FILE_FS_OBJECTID_INFORMATION).
Cette structure doit être alignée sur une limite LONGLONG (8 octets).
Configuration requise
Condition requise | Valeur |
---|---|
En-tête | ntddk.h (inclure Ntddk.h, Ntifs.h, Fltkernel.h) |