PUNLOCK_ROUTINE Rückruffunktion (ntifs.h)

Artikel
02/26/2024

Ein Filter (Legacyfilter oder Minifilter) kann eine PUNLOCK_ROUTINE typisierte Routine als UnlockRoutine-Rückrufroutine des Filters für eine FILE_LOCK Struktur registrieren.

Syntax

PUNLOCK_ROUTINE PunlockRoutine;

void PunlockRoutine(
  PVOID Context,
  PFILE_LOCK_INFO FileLockInfo
)
{...}

Parameter

Context

[in] Kontextzeiger, der an FltProcessFileLock oder FsRtlProcessFileLock übergeben wurde.

FileLockInfo

Undurchsichtiger Zeiger auf die FILE_LOCK_INFO-Struktur für die Bytebereichssperre.

Rückgabewert

Keine

Bemerkungen

Ein Filter (Legacyfilter oder Minifilter) kann optional eine PUNLOCK_ROUTINE typisierte Routine als UnlockRoutine-Rückruf des Filters für eine Bytebereichsdateisperre angeben.

Wenn der Filter eine UnlockRoutine-Routine für eine FILE_LOCK-Struktur angibt, wird diese Routine aufgerufen, wenn die Sperre aus einem gesperrten Bytebereich in einer Datei entfernt wird.

Ein Minifilter gibt diese Routine an, indem ein Zeiger auf die Routine als UnlockRoutine-Parameter für FltAllocateFileLock übergeben wird.

Ein Legacyfilter gibt diese Routine an, indem ein Zeiger auf die Routine als UnlockRoutine-Parameter für FsRtlAllocateFileLock oder FsRtlInitializeFileLock übergeben wird.