FltCheckLockForReadAccess routine

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

Syntax


BOOLEAN FltCheckLockForReadAccess(
  _In_ PFILE_LOCK         FileLock,
  _In_ PFLT_CALLBACK_DATA CallbackData
);

Parameters

FileLock [in]

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

CallbackData [in]

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

This routine is available on Microsoft Windows XP SP2, Microsoft Windows Server 2003 SP1, and later.

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

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

 

 

Send comments about this topic to Microsoft

Show: