Fungsi FltInitializeFileLock (fltkernel.h)

Artikel
03/23/2023

Rutinitas FltInitializeFileLock menginisialisasi struktur FILE_LOCK buram yang telah dialokasikan pemanggil dari kumpulan halaman.

Sintaks

VOID FLTAPI FltInitializeFileLock(
  [out] PFILE_LOCK FileLock
);

Parameter

[out] FileLock

Arahkan ke struktur FILE_LOCK yang tidak diinisialisasi.

Nilai kembali

Tidak ada

Keterangan

Struktur FILE_LOCK buram: yaitu, anggotanya disediakan untuk penggunaan sistem.

Setelah diinisialisasi, struktur FILE_LOCK dapat digunakan untuk mengunci rentang byte dalam file dengan memanggil FltProcessFileLock.

Ini adalah kesalahan pemrograman untuk memanggil FltInitializeFileLock untuk struktur FILE_LOCK yang telah diinisialisasi oleh FltInitializeFileLock atau FltAllocateFileLock, kecuali struktur telah tidak diinisialisasi oleh panggilan berikutnya ke FltUninitializeFileLock.

Ketika struktur FILE_LOCK tidak lagi diperlukan, struktur tersebut dapat tidak diinisialisasi dengan memanggil FltUninitializeFileLock. Struktur FILE_LOCK yang tidak diinisialisasi kemudian dapat diinisialisasi untuk digunakan kembali dengan memanggil FltInitializeFileLock.

Untuk mengalokasikan dan menginisialisasi struktur FILE_LOCK buram baru, panggil FltAllocateFileLock.

Untuk membebaskan struktur FILE_LOCK yang diinisialisasi, panggil FltFreeFileLock.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP SP2
Server minimum yang didukung	Windows Server 2003 SP1
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL