Rutinitas MRxSetFileInfoAtCleanup

Artikel
06/14/2023

Rutinitas MRxSetFileInfoAtCleanup dipanggil oleh RDBSS untuk meminta agar pengalih mini jaringan mengatur informasi file pada objek sistem file saat pembersihan.

Sintaks

PMRX_CALLDOWN MRxSetFileInfoAtCleanup;

NTSTATUS MRxSetFileInfoAtCleanup(
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

Parameter

RxContext [masuk, keluar]
Penunjuk ke struktur RX_CONTEXT. Parameter ini berisi IRP yang meminta operasi.

Mengembalikan nilai

MRxSetFileInfoAtCleanup mengembalikan STATUS_SUCCESS pada keberhasilan atau nilai NTSTATUS yang sesuai.

Keterangan

RDBSS mengeluarkan panggilan ke MRxSetFileInfoAtCleanup selama pembersihan , ketika handel terakhir ke objek file ditutup. Ini berbeda dari operasi tutup yang dipanggil ketika referensi terakhir ke objek file dihapus.

MRxSetFileInfoAtCleanup dipanggil oleh RDBSS jika tanda waktu pada file atau ukuran file telah berubah. Panggilan ke MRxSetFileInfoAtCleanup oleh RDBSS dilakukan secara terpisah untuk setiap perubahan ini. Jika ukuran file dan tanda waktu telah berubah, maka RDBSS melakukan dua panggilan ke MRxSetFileInfoAtCleanup.

Sebelum memanggil MRxSetFileInfoAtCleanup, RDBSS memodifikasi anggota berikut dalam struktur RX_CONTEXT yang ditunjukkan oleh parameter RxContext jika tanda waktu pada file telah berubah:

Anggota Info.FileInformationClass diatur ke nilai FILE_INFORMATION_CLASS FileBasicInformation.

Anggota Info.Buffer diatur ke struktur FILE_BASIC_INFORMATION yang dialokasikan pada tumpukan.

Anggota Info.Length diatur ke ukurandari struktur FILE_BASIC_INFORMATION.

Sebelum memanggil MRxSetFileInfoAtCleanup, RDBSS memodifikasi anggota berikut dalam struktur RX_CONTEXT yang ditunjukkan oleh parameter RxContext jika ukuran file telah berubah:

Anggota Info.FileInformationClass diatur ke nilai FILE_INFORMATION_CLASS FileEndOfFileInformation.

Anggota Info.Buffer diatur ke struktur FILE_END_OF_FILE_INFORMATION yang dialokasikan pada tumpukan.

Anggota Info.Length diatur ke sizeof(FILE_END_OF_FILE_INFORMATION).

RDBSS mengabaikan nilai pengembalian dari MRxSetFileInfoAtCleanup.

Pengalih mini jaringan dapat memilih untuk tidak melakukan apa pun dalam rutinitas ini dan mengembalikan STATUS_SUCCESS. Setiap perubahan pada ukuran file atau tanda waktu akan ditangani selama operasi pembersihan.