FsRtlUninitializeFileLock-Funktion (ntifs.h)

Artikel
02/29/2024

Die FsRtlUninitializeFileLock-Routine hebt eine FILE_LOCK-Struktur auf.

Syntax

void FsRtlUninitializeFileLock(
  [in] PFILE_LOCK FileLock
);

Parameter

[in] FileLock

Zeiger auf die FILE_LOCK-Struktur für die Datei. Diese Struktur muss durch einen vorherigen Aufruf von FsRtlAllocateFileLock oder FsRtlInitializeFileLock initialisiert worden sein.

Rückgabewert

Keine

Bemerkungen

FsRtlUninitializeFileLock hebt eine initialisierte FILE_LOCK-Struktur auf und schließt alle ausstehenden IRP_MJ_LOCK_CONTROL Anforderungen ab. Die nicht initialisierte FILE_LOCK-Struktur kann durch einen nachfolgenden Aufruf von FsRtlInitializeFileLock zur Wiederverwendung initialisiert werden.

FsRtlUninitializeFileLock kann verwendet werden, um eine FILE_LOCK-Struktur zu entinitialisieren, die durch einen vorherigen Aufruf von FsRtlAllocateFileLock oder FsRtlInitializeFileLock initialisiert wurde. Verwenden Sie FsRtlUninitializeFileLock nicht für eine solche FILE_LOCK-Struktur, es sei denn, die Struktur soll zur Wiederverwendung initialisiert werden. Es ist ein Programmierfehler, FsRtlFreeFileLock für eine nicht initialisierte FILE_LOCK-Struktur aufzurufen.

Minifilter müssen FltUninitializeFileLock anstelle von FsRtlIninitializeFileLock aufrufen.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDDIs(storport)