FltCheckLockForReadAccess function (fltkernel.h)

The FltCheckLockForReadAccess routine determines whether the caller has read access to a locked byte range of a file.

Syntax

BOOLEAN FLTAPI FltCheckLockForReadAccess(
  [in] PFILE_LOCK         FileLock,
  [in] PFLT_CALLBACK_DATA CallbackData
);

Parameters

[in] FileLock

Pointer to the FILE_LOCK structure for the file. This structure must have been initialized by a previous call to FltAllocateFileLock or FltInitializeFileLock.

[in] CallbackData

Pointer to the callback data (FLT_CALLBACK_DATA) structure for the IRP_MJ_READ operation.

Return value

FltCheckLockForReadAccess returns TRUE if the process has read access, FALSE otherwise.

Remarks

FltCheckLockForReadAccess checks whether the caller has read access to the entire byte range indicated in the callback data structure.

FltCheckLockForReadAccess does not complete the IRP_MJ_READ operation.

To allocate and initialize a new file lock structure, call FltAllocateFileLock.

To free an initialized FILE_LOCK structure, call FltFreeFileLock.

Requirements

Requirement Value
Minimum supported client Windows XP SP2
Minimum supported server Windows Server 2003 SP1
Target Platform Universal
Header fltkernel.h (include Fltkernel.h)
Library FltMgr.lib
IRQL <= APC_LEVEL

See also

FLT_CALLBACK_DATA

FltAllocateFileLock

FltCheckLockForWriteAccess

FltFreeFileLock

FltInitializeFileLock

FltProcessFileLock

FltUninitializeFileLock

FsRtlCheckLockForReadAccess

IRP_MJ_READ