FltInitializeFileLock-Funktion (fltkernel.h)
Die FltInitializeFileLock Routine initialisiert eine undurchsichtige FILE_LOCK Struktur, die der Aufrufer aus dem ausgelagerten Pool zugewiesen hat.
Syntax
VOID FLTAPI FltInitializeFileLock(
[out] PFILE_LOCK FileLock
);
Parameter
[out] FileLock
Zeiger auf eine nicht initialisierte FILE_LOCK Struktur.
Rückgabewert
Nichts
Bemerkungen
Die FILE_LOCK-Struktur ist undurchsichtig: d. h., die Mitglieder sind für die Systemverwendung reserviert.
Nach der Initialisierung kann die FILE_LOCK Struktur verwendet werden, um einen Bytebereich in einer Datei zu sperren, indem FltProcessFileLockaufgerufen wird.
Es ist ein Programmierfehler, FltInitializeFileLock für eine FILE_LOCK Struktur aufzurufen, die bereits von FltInitializeFileLock oder FltAllocateFileLockinitialisiert wurde, es sei denn, die Struktur wurde durch einen nachfolgenden Aufruf von FltUninitializeFileLocknicht initialisiert.
Wenn die FILE_LOCK Struktur nicht mehr benötigt wird, kann sie durch Aufrufen FltUninitializeFileLocknicht initialisiert werden. Die nicht initialisierte FILE_LOCK-Struktur kann dann für die Wiederverwendung initialisiert werden, indem FltInitializeFileLockaufgerufen wird.
Rufen Sie FltAllocateFileLockauf, um eine neue undurchsichtige FILE_LOCK Struktur zuzuweisen und zu initialisieren.
Rufen Sie FltFreeFileLockauf, um eine initialisierte FILE_LOCK Struktur frei zu geben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP SP2 |
| mindestens unterstützte Server- | Windows Server 2003 SP1 |
| Zielplattform- | Universal |
| Header- | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| DLL- | Fltmgr.sys |
| IRQL- | <= APC_LEVEL |