Fungsi FsRtlGetNextFileLock (ntifs.h)

Artikel
02/26/2024

Rutinitas FsRtlGetNextFileLock digunakan untuk menghitung kunci rentang byte yang saat ini ada untuk file tertentu.

Sintaks

PFILE_LOCK_INFO FsRtlGetNextFileLock(
  [in] PFILE_LOCK FileLock,
  [in] BOOLEAN    Restart
);

Parameter

[in] FileLock

Arahkan ke struktur FILE_LOCK untuk file. Struktur ini harus diinisialisasi oleh panggilan sebelumnya ke FsRtlAllocateFileLock atau FsRtlInitializeFileLock.

[in] Restart

Atur ke TRUE jika enumerasi dimulai di awal daftar kunci rentang byte. Atur ke FALSE jika melanjutkan enumerasi dari panggilan sebelumnya.

Untuk menghitung semua kunci rentang byte untuk file tertentu, gunakan FsRtlGetNextFileLock sebagai berikut:

for (p = FsRtlGetNextFileLock( FileLock, TRUE );
     p != NULL;
     p = FsRtlGetNextFileLock( FileLock, FALSE )) {
        // Process the lock information pointed to by p
}

Nilai kembali

FsRtlGetNextFileLock mengembalikan penunjuk ke struktur FILE_LOCK_INFO untuk kunci rentang byte berikutnya, jika ada. Jika tidak ada lagi kunci rentang byte untuk file ini, FsRtlGetNextFileLock mengembalikan NULL.

Keterangan

Kunci rentang byte tidak dijumlahkan dalam urutan tertentu.

Perhatikan bahwa karena status enumerasi saat ini disimpan dalam struktur FILE_LOCK, pemanggil harus berhati-hati untuk menyinkronkan panggilan ke FsRtlGetNextFileLock, dan untuk menghindari memodifikasi salah satu struktur yang dikembalikannya. Jika beberapa utas mencoba menggunakan FsRtlGetNextFileLock pada saat yang sama, hasilnya tidak akan dapat diprediksi, dan enumerasi tidak akan selesai dengan andal.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport)