Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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é. À la suite de cette opération, tout le contenu d’un fichier sauvegardé est lu, 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 d’instance opaque pour l’appelant. Ce paramètre est obligatoire et ne peut pas être NULL.
FileObject : [in] : FltFsControlFile uniquement. Objet pointeur de fichier du fichier pour lequel l’association de stockage est supprimée. Ce paramètre est obligatoire et ne peut pas être NULL.
FileHandle [in] : ZwFsControlFile uniquement. Handle du fichier pour lequel l’association de stockage est supprimée. Ce paramètre est obligatoire et ne peut pas être NULL.
FsControlCode [in] : code de contrôle de l’opération. Utilisez FSCTL_DELETE_EXTERNAL_BACKING pour cette opération.
InputBuffer [in] : Aucun. Défini sur NULL.
InputBufferLength [in] : défini sur 0.
OutputBuffer [out] : Aucun. Défini 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 | Sens |
|---|---|
| STATUS_OBJECT_NOT_EXTERNALLY_BACKED | Le fichier n’est pas sauvegardé en externe. |
| STATUS_INVALID_DEVICE_REQUEST | Le service de stockage n’est pas présent ou ne démarre pas. |
| STATUS_ACCÈS_REFUSÉ | Le demandeur n’a pas l’autorisation de supprimer les associations de stockage pour le fichier. |
Remarques
En raison 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.
Spécifications
| Type de condition requise | Besoin |
|---|---|
| Client minimum pris en charge | Mise à jour Windows 8.1 |
| En-tête de page | Ntifs.h (include Ntifs.h ou Fltkernel.h) |