code de contrôle FSCTL_SET_PERSISTENT_VOLUME_STATE
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) |