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