FltInitializeFileLock-Funktion (fltkernel.h)
Die FltInitializeFileLock-Routine initialisiert eine undurchsichtige FILE_LOCK Struktur, die der Aufrufer aus dem ausgelagerten Pool zugeordnet hat.
Syntax
VOID FLTAPI FltInitializeFileLock(
[out] PFILE_LOCK FileLock
);
Parameter
[out] FileLock
Zeiger auf eine nicht initialisierte FILE_LOCK-Struktur .
Rückgabewert
Keine
Bemerkungen
Die FILE_LOCK-Struktur ist undurchsichtig, d. h. ihre Member 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 FltProcessFileLock aufgerufen wird.
Es ist ein Programmierfehler, FltInitializeFileLock für eine FILE_LOCK-Struktur aufzurufen, die bereits von FltInitializeFileLock oder FltAllocateFileLock initialisiert wurde, es sei denn, die Struktur wurde durch einen nachfolgenden Aufruf von FltUninitializeFileLock nicht initialisiert.
Wenn die FILE_LOCK-Struktur nicht mehr benötigt wird, kann sie durch Aufrufen von FltUninitializeFileLock aufgehoben werden. Die nicht initialisierte FILE_LOCK-Struktur kann dann zur Wiederverwendung initialisiert werden, indem FltInitializeFileLock aufgerufen wird.
Rufen Sie FltAllocateFileLock auf, um eine neue undurchsichtige FILE_LOCK-Struktur zuzuordnen und zu initialisieren.
Um eine initialisierte FILE_LOCK-Struktur frei zu geben, rufen Sie FltFreeFileLock auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP SP2 |
| Unterstützte Mindestversion (Server) | Windows Server 2003 SP1 |
| Zielplattform | Universell |
| Header | fltkernel.h (fltkernel.h einschließen) |
| Bibliothek | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |