Edit

Share via

FsRtlFastUnlockAllByKey function (ntifs.h)

  • Article

The FsRtlFastUnlockAllByKey routine releases all byte-range locks that were acquired by the specified process, with the specified key value, for a file.

Syntax

NTSTATUS FsRtlFastUnlockAllByKey(
  [in]           PFILE_LOCK   FileLock,
  [in]           PFILE_OBJECT FileObject,
  [in]           PEPROCESS    ProcessId,
  [in]           ULONG        Key,
  [in, optional] PVOID        Context
);

Parameters

[in] FileLock

A pointer to the FILE_LOCK structure for the file. This structure must have been initialized by a previous call to FsRtlAllocateFileLock or FsRtlInitializeFileLock.

[in] FileObject

A pointer to the file object for the file.

[in] ProcessId

A pointer to the process ID for the process.

[in] Key

The key value.

[in, optional] Context

Optional context pointer to be used when completing IRPs.

Return value

FsRtlFastUnlockAllByKey returns STATUS_SUCCESS or an error status code such as STATUS_RANGE_NOT_LOCKED.

Remarks

After releasing the byte-range locks, FsRtlFastUnlockAllByKey completes any currently queued lock IRPs that can now be completed.

Requirements

Requirement Value
Target Platform Universal
Header ntifs.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL
DDI compliance rules HwStorPortProhibitedDDIs(storport)

See also

FsRtlAllocateFileLock

FsRtlInitializeFileLock