FSCTL_DELETE_REPARSE_POINT kode kontrol

Artikel
03/14/2023

Kode kontrol FSCTL_DELETE_REPARSE_POINT menghapus titik pemisahan ulang dari file atau direktori yang ditentukan. Menggunakan FSCTL_DELETE_REPARSE_POINT tidak menghapus file atau direktori.

Untuk melakukan operasi ini, panggil ZwFsControlFile dengan parameter berikut.

Minifilter harus menggunakan FltUntagFile alih-alih FSCTL_DELETE_REPARSE_POINT untuk menghapus titik pemilah ulang.

Untuk informasi selengkapnya tentang titik pemilah ulang dan kode kontrol FSCTL_DELETE_REPARSE_POINT, lihat dokumentasi Microsoft Windows SDK.

Parameter

FileHandle [in]: Handel file untuk file atau direktori tempat titik pemisahan ulang akan dihapus. Pemanggil harus memiliki akses tulis ke file atau direktori. Parameter ini diperlukan dan tidak boleh NULL.
FsControlCode [in]: Kode kontrol untuk operasi. Gunakan FSCTL_DELETE_REPARSE_POINT untuk operasi ini.
InputBuffer [in]: Penunjuk ke struktur REPARSE_GUID_DATA_BUFFER atau REPARSE_DATA_BUFFER . Tag yang ditentukan dalam anggota ReparseTag dari struktur ini harus cocok dengan tag titik pemilahan ulang yang akan dihapus, dan anggota ReparseDataLength harus nol. Selain itu, jika titik reparse adalah titik reparse pihak ketiga (non-Microsoft), GUID yang ditentukan dalam anggota ReparseGuid dari struktur REPARSE_GUID_DATA_BUFFER harus cocok dengan GUID titik pemisahan ulang yang akan dihapus.
InputBufferLength [in]: Ukuran, dalam byte, dari buffer yang diacu oleh parameter InputBuffer . Untuk struktur REPARSE_GUID_DATA_BUFFER, nilai ini harus persis REPARSE_GUID_DATA_BUFFER_HEADER_SIZE. Untuk struktur REPARSE_DATA_BUFFER, nilai ini harus persis REPARSE_DATA_BUFFER_HEADER_SIZE.
OutputBuffer [out]: Tidak ada. Atur ke NULL.
OutputBufferLength [out]: Atur ke 0.

Blok status

ZwFsControlFile mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti salah satu hal berikut ini:

Kode	Makna
STATUS_IO_REPARSE_DATA_INVALID	Salah satu nilai parameter yang ditentukan tidak valid. Ini adalah kode kesalahan.
STATUS_IO_REPARSE_TAG_INVALID	Tag reparse yang ditentukan oleh pemanggil tidak valid. Ini adalah kode kesalahan.
STATUS_IO_REPARSE_TAG_MISMATCH	Tag reparse yang ditentukan oleh pemanggil tidak cocok dengan tag titik reparse yang akan dihapus. Ini adalah kode kesalahan.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	Titik pemilah ulang adalah titik pemilah ulang pihak ketiga, dan GUID reparse yang ditentukan oleh pemanggil tidak cocok dengan GUID titik pemilah ulang yang akan dihapus. Ini adalah kode kesalahan.