Partager via

code de contrôle FSCTL_SET_PERSISTENT_VOLUME_STATE

  • Article

Le code de contrôle FSCTL_SET_PERSISTENT_VOLUME_STATE définit des paramètres persistants pour 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 avoir la valeur 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 avoir la valeur NULL.

  • FsControlCode [in] : code de contrôle de l’opération. Utilisez FSCTL_SET_PERSISTENT_VOLUME_STATE pour cette opération.

  • InputBuffer [in] : pointeur vers une structure de FILE_FS_PERSISTENT_VOLUME_INFORMATION allouée par l’appelant qui contient les paramètres persistants d’un volume de système de fichiers.

  • InputBufferLength [in] : taille, en octets, de la mémoire tampon pointée vers le paramètre InputBuffer .

  • OutputBuffer [out] : non utilisé avec cette opération ; défini sur NULL.

  • OutputBufferLength [out] : non utilisé avec cette opération ; défini sur zéro.

Bloc d’état

FltFsControlFile ou ZwFsControlFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Code Signification
STATUS_NOT_SUPPORTED Le paramètre de Registre demandé n’est pas par volume, ou 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 pour contenir les données des paramètres persistants. Dans ce cas, aucune donnée de paramètres persistants n’est définie. 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)

Voir aussi

FILE_FS_PERSISTENT_VOLUME_INFORMATION

FltFsControlFile

ZwFsControlFile