ZwLockFile 函数 （ntifs.h）
ZwLockFile 例程请求指定文件的字节范围锁。
语法
NTSYSAPI NTSTATUS ZwLockFile(
[in] HANDLE FileHandle,
[in, optional] HANDLE Event,
[in, optional] PIO_APC_ROUTINE ApcRoutine,
[in, optional] PVOID ApcContext,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[in] PLARGE_INTEGER ByteOffset,
[in] PLARGE_INTEGER Length,
[in] ULONG Key,
[in] BOOLEAN FailImmediately,
[in] BOOLEAN ExclusiveLock
);
参数
[in] FileHandle
请求字节范围锁的文件句柄。
[in, optional] Event
调用方创建事件的句柄。 如果未 NULL，则调用方将进入等待状态，直到操作成功，此时事件将设置为 Signaled 状态。
[in, optional] ApcRoutine
指向调用方提供的 APC 例程的指针，该例程在操作完成后执行。 可以为 NULL
[in, optional] ApcContext
指向 APC 例程的调用方指定上下文的指针。 此值在执行时传递给 APC 例程。 可以为 NULL
[out] IoStatusBlock
指向包含最终状态的 IO_STATUS_BLOCK 结构的指针。
[in] ByteOffset
指向一个变量的指针，该变量指定要锁定的范围的起始字节偏移量。
[in] Length
指向变量的指针，该变量指定要锁定的范围长度（以字节为单位）。
[in] Key
用于描述相关锁组的调用方分配的值。 此值应设置为零。
[in] FailImmediately
如果 TRUE，则当文件无法锁定时立即返回。 如果 FALSE，请等待授予锁定请求。
[in] ExclusiveLock
如果 TRUE，则字节范围锁是排他性的;否则为共享锁。
返回值
ZwLockFile 例程返回STATUS_SUCCESS或相应的错误 NTSTATUS 值，例如以下值之一。
| 错误代码 | 描述 |
|---|---|
| STATUS_INSUFFICIENT_RESOURCES | 资源不足，无法授予指定文件的字节范围锁。 |
| STATUS_LOCK_NOT_GRANTED | 未为指定文件授予字节范围锁。 |
言论
ZwLockFile 的调用方必须在 IRQL = PASSIVE_LEVEL上运行，启用了特殊内核 APC。
注意
如果在用户模式下调用 ZwLockFile 函数，则应使用名称“NtLockFile”而不是“ZwLockFile”。
对于内核模式驱动程序的调用，NtXxx 和 ZwXxx 版本的 Windows 本机系统服务例程的行为方式可能以不同的方式处理和解释输入参数。 有关 NtXxx 与 ZwXxx 例程之间的关系的详细信息，请参阅 使用 Nt 和 Zw 版本的本机系统服务例程。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 7 |
| 目标平台 | 普遍 |
| 标头 | ntifs.h（包括 Ntifs.h、FltKernel.h） |
| 库 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL（请参阅“备注”部分） |
| DDI 符合性规则 | HwStorPortProhibitedDIS（storport），PowerIrpDDis（wdm） |