FsRtlFastUnlockSingle function (ntifs.h)

The FsRtlFastUnlockSingle routine releases a byte-range lock that was acquired by the specified process, with the specified key value, file offset, and length, for a file.

Syntax

NTSTATUS FsRtlFastUnlockSingle(
  [in]           PFILE_LOCK     FileLock,
  [in]           PFILE_OBJECT   FileObject,
  [in]           LARGE_INTEGER  *FileOffset,
  [in]           PLARGE_INTEGER Length,
  [in]           PEPROCESS      ProcessId,
  [in]           ULONG          Key,
  [in, optional] PVOID          Context,
  [in]           BOOLEAN        AlreadySynchronized
);

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] FileOffset

A pointer to a variable that specifies the starting byte offset within the file of the range to be unlocked. The memory pointed to must not be pageable.

[in] Length

A pointer to a variable that specifies the length, in bytes, of the range to be unlocked. The memory pointed to must not be pageable.

[in] ProcessId

A pointer to the process ID for the process.

[in] Key

The key for the byte-range lock.

[in, optional] Context

An optional context pointer to be used when completing IRPs.

[in] AlreadySynchronized

This parameter is obsolete, but is retained for compatibility with legacy drivers.

Return value

The FsRtlFastUnlockSingle routine returns STATUS_SUCCESS or an error status code such as STATUS_RANGE_NOT_LOCKED.

Requirements

See also

FsRtlAllocateFileLock

FsRtlInitializeFileLock