FsRtlAreThereCurrentFileLocks-Makro (ntifs.h)

Das FsRtlAreThereCurrentFileLocks-Makro überprüft, ob für die angegebene Datei Bytebereichssperren vorhanden sind.

Syntax

void FsRtlAreThereCurrentFileLocks(
   FL
);

Parameter

FL

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

Dieses Makro verhält sich wie eine BOOLEAN-Funktion und gibt TRUE zurück, wenn für die angegebene Datei Bytebereichssperren vorhanden sind, oder FALSE, wenn keine vorhanden ist.

Dateisysteme und Filtertreiber rufen häufig FsRtlAreThereCurrentFileLocks aus ihren FastIoCheckIfPossible-Routinen auf.

Wenn seit dem Öffnen der angegebenen Datei eine Bytebereichssperre vorhanden ist, gibt FsRtlAreThereCurrentFileLocks TRUE zurück, es sei denn, die relevante FILE_LOCK wird neu initialisiert. Wenn eine Sperre eingerichtet und dann freigegeben wurde, kann die Verwendung von FsRtlAreThereCurrentFileLocks die Zuweisung von Oplocks unnötig verhindern. Verwenden Sie FsRtlAreThereCurrentOrInProgressFileLocks , um dieses Problem zu vermeiden.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile ntifs.h (include Ntifs.h)
IRQL Beliebige Ebene

Weitere Informationen

FsRtlAllocateFileLock

FsRtlAreThereCurrentOrInProgressFileLocks

FsRtlInitializeFileLock