PUNLOCK_ROUTINE Rückruffunktion (ntifs.h)

Artikel
12/21/2024

Ein Filter (Legacyfilter oder Minifilter) kann eine PUNLOCK_ROUTINE typierte Routine als UnlockRoutine- Rückrufroutine 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

Nichts

Bemerkungen

Ein Filter (Legacyfilter oder Minifilter) kann optional eine PUNLOCK_ROUTINE typierte Routine als UnlockRoutine- Rückruf für eine Bytebereich-Dateisperre 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 als UnlockRoutine Parameter für FltAllocateFileLockan die Routine übergeben wird.

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