FSCTL_SET_REPARSE_POINT kode kontrol

Artikel
02/07/2024

Kode kontrol FSCTL_SET_REPARSE_POINT menetapkan titik pemilah ulang pada file atau direktori.

Untuk melakukan operasi ini, panggil ZwFsControlFile dengan parameter berikut.

Minifilter harus menggunakan FltTagFile alih-alih FSCTL_SET_REPARSE_POINT untuk mengatur titik pemilah ulang.

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

Parameter

FileHandle [in]: Handel file untuk file atau direktori tempat mengatur titik reparse. Parameter ini diperlukan dan tidak boleh NULL.
FsControlCode [in]: Kode kontrol untuk operasi. Gunakan FSCTL_SET_REPARSE_POINT untuk operasi ini.
InputBuffer [in]: Penunjuk ke struktur REPARSE_GUID_DATA_BUFFER atau REPARSE_DATA_BUFFER yang dialokasikan pemanggil yang berisi data titik pemilah ulang. Jika titik pemilah ulang yang ada sedang dimodifikasi, tag yang ditentukan dalam anggota ReparseTag dari struktur ini harus cocok dengan tag titik pemilah ulang yang akan dimodifikasi. Selain itu, jika titik pemilah ulang adalah titik reparse pihak ketiga (non-Microsoft), GUID yang ditentukan dalam anggota struktur ReparseGuid adalah struktur REPARSE_GUID_DATA_BUFFER harus cocok dengan GUID dari titik reparse yang akan dimodifikasi.
InputBufferLength [in]: Ukuran, dalam byte, dari buffer yang diacu oleh parameter InputBuffer . Untuk struktur REPARSE_GUID_DATA_BUFFER, nilai ini setidaknya harus REPARSE_GUID_DATA_BUFFER_HEADER_SIZE, ditambah ukuran data yang ditentukan pengguna, dan harus kurang dari atau sama dengan MAXIMUM_REPARSE_DATA_BUFFER_SIZE. Untuk struktur REPARSE_DATA_BUFFER, nilai ini setidaknya harus REPARSE_DATA_BUFFER_HEADER_SIZE, ditambah ukuran data yang ditentukan pengguna, dan harus kurang dari atau sama dengan MAXIMUM_REPARSE_DATA_BUFFER_SIZE.
OutputBuffer [out]: Tidak digunakan dengan operasi ini; atur ke NULL.
OutputBufferLength [out]: Tidak digunakan dengan operasi ini; atur ke nol.

Blok status

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

Kode	Makna
STATUS_DIRECTORY_NOT_EMPTY	Titik pemilahan ulang tidak dapat disetel pada direktori yang tidak kosong. Ini adalah kode kesalahan.
STATUS_EAS_NOT_SUPPORTED	Titik penguraian ulang tidak dapat diatur pada file jika permintaan ini sedang dalam transaksi. Ini adalah kode kesalahan.
STATUS_IO_REPARSE_DATA_INVALID	Salah satu nilai parameter yang ditentukan 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 dimodifikasi. Ini adalah kode kesalahan.
STATUS_NOT_A_REPARSE_POINT	File atau direktori bukan titik pemilah ulang. Ini adalah kode kesalahan.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	Titik reparse adalah titik reparse pihak ketiga, dan GUID pemilah ulang yang ditentukan oleh pemanggil tidak cocok dengan GUID dari titik pemisahan ulang yang akan dimodifikasi. Ini adalah kode kesalahan.