code de contrôle FSCTL_DELETE_EXTERNAL_BACKING
Le code de contrôle FSCTL_DELETE_EXTERNAL_BACKING supprime l’association d’un fichier à un fournisseur de stockage externe, y compris le fournisseur wim (Windows Image Format) ou le fournisseur de fichiers compressés. À la suite de cette opération, tout le contenu d’un fichier sauvegardé est lu, décompressé et écrit dans le fichier.
Pour effectuer cette opération, appelez FltFsControlFile ou ZwFsControlFile avec les paramètres suivants.
Paramètres
Instance [in] : FltFsControlFile uniquement. Pointeur de instance opaque pour l’appelant. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
FileObject : [in] : FltFsControlFile uniquement. Objet pointeur de fichier du fichier pour lequel l’association de sauvegarde est supprimée. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
FileHandle [in] : ZwFsControlFile uniquement. Handle du fichier pour lequel l’association de sauvegarde est supprimée. 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_DELETE_EXTERNAL_BACKING pour cette opération.
InputBuffer [in] : Aucun. valeur de l’en-tête définie sur Null.
InputBufferLength [in] : défini sur 0.
OutputBuffer [out] : Aucun. valeur de l’en-tête définie sur Null.
OutputBufferLength [out] : défini sur 0.
Bloc d’état
FltFsControlFile ou ZwFsControlFile retourne STATUS_SUCCESS si l’opération réussit. Sinon, la fonction appropriée peut retourner l’une des valeurs NTSTATUS suivantes.
| Code | Signification |
|---|---|
| STATUS_OBJECT_NOT_EXTERNALLY_BACKED | Le fichier n’est pas sauvegardé en externe. |
| STATUS_INVALID_DEVICE_REQUEST | Le service de sauvegarde n’est pas présent ou n’est pas démarré. |
| STATUS_ACCESS_DENIED | Le demandeur n’a pas l’autorisation de supprimer les associations de stockage pour le fichier. |
Remarques
À la suite de l’opération de suppression, le contenu du fichier est lu à partir de la source de stockage et le fichier entier est écrit dans le volume.
Configuration requise
| Type d’exigence | Condition requise |
|---|---|
| Client minimal pris en charge | Mise à jour Windows 8.1 |
| En-tête | Ntifs.h (inclure Ntifs.h ou Fltkernel.h) |