FsRtlFastCheckLockForRead function (ntifs.h)

  • Article

The FsRtlFastCheckLockForRead routine determines whether the specified process has read access to a locked byte range of a file.

Syntax

BOOLEAN FsRtlFastCheckLockForRead(
  [in] PFILE_LOCK     FileLock,
  [in] PLARGE_INTEGER StartingByte,
  [in] PLARGE_INTEGER Length,
  [in] ULONG          Key,
  [in] PFILE_OBJECT   FileObject,
  [in] PVOID          ProcessId
);

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

A pointer to a variable that specifies the starting byte offset within the file of the byte range to check.

[in] Length

A pointer to a variable that specifies the length, in bytes, of the range to check.

[in] Key

The key for the byte range lock.

[in] FileObject

A pointer to the file object for the file.

[in] ProcessId

A pointer to the EPROCESS for the process.

Return value

The FsRtlFastCheckLockForRead routine returns TRUE if the specified process has read access, FALSE otherwise.

Requirements

Requirement Value
Minimum supported client Windows 2000
Target Platform Universal
Header ntifs.h (include FltKernel.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL
DDI compliance rules HwStorPortProhibitedDDIs(storport)

See also

FsRtlAllocateFileLock

FsRtlFastCheckLockForWrite

FsRtlInitializeFileLock