FSCTL_GET_REPARSE_POINT kode kontrol

Kode kontrol FSCTL_GET_REPARSE_POINT mengambil data titik pemilah ulang yang terkait dengan file atau direktori yang ditentukan.

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

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

Parameter

FileObject [in]: FltFsControlFile saja. Penunjuk objek file untuk file atau direktori tempat mengambil data titik pemilah ulang. Parameter ini diperlukan dan tidak boleh NULL.
FileHandle [in]: ZwFsControlFile saja. Handel file untuk file atau direktori tempat mengambil data titik pemilah ulang. Parameter ini diperlukan dan tidak boleh NULL.
FsControlCode [in]: Kode kontrol untuk operasi. Gunakan FSCTL_GET_REPARSE_POINT untuk operasi ini.
InputBuffer [in]: Tidak digunakan dengan operasi ini; atur ke NULL.
InputBufferLength [in]: Tidak digunakan dengan operasi ini; atur ke nol.
OutputBuffer [out]: Penunjuk ke struktur REPARSE_GUID_DATA_BUFFER atau REPARSE_DATA_BUFFER yang dialokasikan pemanggil yang menerima data titik pemilah ulang.

OutputBufferLength [out]: Ukuran, dalam byte, dari buffer yang diacu oleh parameter OutputBuffer . Jumlah byte dihitung sebagai berikut:

Struktur	OutputBufferLength
REPARSE_GUID_DATA_BUFFER	Setidaknya harus REPARSE_GUID_DATA_BUFFER_HEADER_SIZE ditambah ukuran data yang ditentukan pengguna yang diharapkan; dan harus kurang dari atau sama dengan MAXIMUM_REPARSE_DATA_BUFFER_SIZE.
REPARSE_DATA_BUFFER	Setidaknya harus REPARSE_DATA_BUFFER_HEADER_SIZE ditambah ukuran data yang ditentukan pengguna yang diharapkan; dan harus kurang dari atau sama dengan MAXIMUM_REPARSE_DATA_BUFFER_SIZE.

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

Kode	Makna
STATUS_BUFFER_OVERFLOW	Buffer yang ditunjuk parameter OutputBuffer cukup besar untuk menyimpan bagian tetap dari struktur REPARSE_GUID_DATA_BUFFER atau REPARSE_DATA_BUFFER tetapi bukan data yang ditentukan pengguna. Dalam hal ini, hanya byte OutputBufferLength yang dikembalikan dalam buffer OutputBuffer . Parameter LengthReturned ke FltFsControlFile menerima panjang aktual, dalam byte, data yang dikembalikan. Ini adalah kode peringatan.
STATUS_BUFFER_TOO_SMALL	Buffer yang ditunjuk OutputBuffer kurang dari `sizeof(REPARSE_GUID_DATA_BUFFER)` dan tidak cukup besar untuk menyimpan data titik pemilah ulang. Parameter LengthReturned ke FltFsControlFile (atau anggota Informasi parameter IoStatus ke ZwFsControlFile) menerima ukuran buffer yang diperlukan. Dalam hal ini, tidak ada data titik pemilah ulang yang dikembalikan. Ini adalah kode kesalahan.
STATUS_IO_REPARSE_DATA_INVALID	Salah satu nilai parameter yang ditentukan tidak valid. Ini adalah kode kesalahan.
STATUS_NOT_A_REPARSE_POINT	File atau direktori bukan titik pemilah ulang. Ini adalah kode kesalahan.