Bagikan melalui


FSCTL_DELETE_EXTERNAL_BACKING kode kontrol

Kode kontrol FSCTL_DELETE_EXTERNAL_BACKING menghapus asosiasi file dengan penyedia dukungan eksternal, termasuk penyedia Windows Image Format (WIM) atau penyedia file terkompresi. Sebagai hasil dari operasi ini, seluruh konten file yang didukung dibaca, didekompresi, dan ditulis ke dalam file.

Untuk melakukan operasi ini, panggil FltFsControlFile atau ZwFsControlFile dengan parameter berikut.

Parameter

  • Instance [in]: FltFsControlFile saja. Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

  • FileObject: [in]: FltFsControlFile saja. Objek penunjuk file dari file tempat asosiasi cadangan dihapus. Parameter ini diperlukan dan tidak boleh NULL.

  • FileHandle [in]: ZwFsControlFile saja. Handel file tempat asosiasi dukungan dihapus. Parameter ini diperlukan dan tidak boleh NULL.

  • FsControlCode [in]: Kode kontrol untuk operasi. Gunakan FSCTL_DELETE_EXTERNAL_BACKING untuk operasi ini.

  • InputBuffer [in]: Tidak ada. Atur ke NULL.

  • InputBufferLength [in]: Atur ke 0.

  • OutputBuffer [out]: Tidak ada. Atur ke NULL.

  • OutputBufferLength [out]: Atur ke 0.

Blok status

FltFsControlFile atau ZwFsControlFile mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, fungsi yang sesuai mungkin mengembalikan salah satu nilai NTSTATUS berikut.

Kode Makna
STATUS_OBJECT_NOT_EXTERNALLY_BACKED File tidak didukung secara eksternal.
STATUS_INVALID_DEVICE_REQUEST Layanan dukungan tidak ada atau tidak dimulai.
STATUS_ACCESS_DENIED Pemohon tidak memiliki izin untuk menghapus asosiasi dukungan untuk file tersebut.

Keterangan

Sebagai hasil dari operasi penghapusan, konten file dibaca dari sumber pencadangan dan seluruh file ditulis ke volume.

Persyaratan

Jenis persyaratan Persyaratan
Klien minimum yang didukung Pembaruan Windows 8.1
Header Ntifs.h (termasuk Ntifs.h atau Fltkernel.h)

Lihat juga

FltFsControlFile

ZwFsControlFile

FSCTL_SET_EXTERNAL_BACKING