code de contrôle FSCTL_QUERY_PERSISTENT_VOLUME_STATE
Le code de contrôle FSCTL_QUERY_PERSISTENT_VOLUME_STATE récupère les paramètres persistants d’un volume de système de fichiers. Les paramètres persistants restent sur un volume de système de fichiers entre les redémarrages de l’ordinateur.
Pour effectuer cette opération, appelez FltFsControlFile ou ZwFsControlFile avec les paramètres suivants.
Paramètres
FileObject [in] : FltFsControlFile uniquement. Pointeur d’objet de fichier pour le volume du système de fichiers. Ce paramètre est obligatoire et ne peut pas être NULL.
FileHandle [in] : ZwFsControlFile uniquement. Handle de fichier pour le volume du système de fichiers. Ce paramètre est obligatoire et ne peut pas être NULL.
FsControlCode [in] : code de contrôle pour l’opération. Utilisez FSCTL_QUERY_PERSISTENT_VOLUME_STATE pour cette opération.
InputBuffer [in] : pointeur vers une structure de FILE_FS_PERSISTENT_VOLUME_INFORMATION allouée par l’appelant.
InputBufferLength [in] : taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre InputBuffer .
OutputBuffer [out] : pointeur vers une structure de FILE_FS_PERSISTENT_VOLUME_INFORMATION allouée à l’appelant qui reçoit les paramètres persistants d’un volume de système de fichiers.
OutputBufferLength [out] : taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre OutputBuffer .
Bloc d’état
FltFsControlFile ou ZwFsControlFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, telle que l’une des suivantes :
| Code | Signification |
|---|---|
| STATUS_NOT_SUPPORTED | L’appelant a spécifié un numéro de version incorrect dans le membre Version de FILE_FS_PERSISTENT_VOLUME_INFORMATION. |
| STATUS_INVALID_PARAMETER | Le volume du système de fichiers n’est pas un volume utilisateur ouvert, ou l’appelant a spécifié un indicateur non valide dans le membre FlagMask de FILE_FS_PERSISTENT_VOLUME_INFORMATION. |
| STATUS_BUFFER_TOO_SMALL | La mémoire tampon vers laquelle pointe le paramètre InputBuffer n’est pas assez grande (autrement dit, la mémoire tampon est inférieure à sizeof(FILE_FS_PERSISTENT_VOLUME_INFORMATION)). Dans ce cas, aucune donnée de paramètres persistants n’est retournée. Il s’agit d’un code d’erreur. |
| STATUS_ACCESS_DENIED | L’appelant ne peut pas accéder au volume du système de fichiers. |
| STATUS_VOLUME_DISMOUNTED | Le volume du système de fichiers est démonté. |
| STATUS_TOO_LATE | Le volume du système de fichiers est arrêté. |
| STATUS_MEDIA_WRITE_PROTECTED | Le volume du système de fichiers est en lecture seule. |
Configuration requise
| Type d’exigence | Condition requise |
|---|---|
| Client minimal pris en charge | Windows 7 |
| En-tête | Ntifs.h (inclure Ntifs.h ou Fltkernel.h) |