FSCTL_REQUEST_OPLOCK_LEVEL_2 IOCTL (winioctl.h)

请求对文件使用级别 2 的机会锁。

若要执行此操作,请使用以下参数调用 DeviceIoControl 函数。

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to file
  FSCTL_REQUEST_OPLOCK_LEVEL_2,     // dwIoControlCode
  NULL,                             // lpInBuffer
  0,                                // nInBufferSize
  NULL,                             // lpOutBuffer
  0,                                // nOutBufferSize
  (LPDWORD) lpBytesReturned,        // number of bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

注解

此操作仅由从本地服务器请求机会锁的客户端应用程序使用。 从远程服务器请求机会性锁的客户端应用程序不得直接请求它们-网络重定向程序以透明方式请求应用程序的机会性锁。 尝试使用此操作从远程服务器请求机会锁将导致请求被拒绝。

如果需要新的 oplock 类型,则必须关闭句柄并使用 CreateFile 重新打开新句柄,并且必须使用所需的FSCTL_REQUEST_OPLOCK_XXX控制代码在新句柄上调用 DeviceIoControl。 若要在可以更改 oplock 类型的句柄上请求 oplock, (无需在) 关闭并重新打开该句柄,请使用 FSCTL_REQUEST_OPLOCK 控件代码。

使用 FSCTL_REQUEST_OPLOCK_LEVEL_2 请求对文件进行 2 级机会锁。 客户端文件系统可以在 (缓存读取数据,但不能在本地) 写入数据,只要持有级别 2 锁。

当锁断开时,文件系统不需要请求级别 2 机会锁的应用程序的确认。 锁定断开后,将通知网络重定向程序不要将文件中的任何缓存数据视为有效数据。 有关详细信息,请参阅 中断 Oplock

有关详细信息,请参阅 机会锁的类型

有关各种 oplock 控制代码的比较,请参阅 FSCTL_REQUEST_OPLOCK

如果在非重叠 (同步) 模式下打开文件,FSCTL_REQUEST_OPLOCK_LEVEL_2控制代码将失败。

有关重叠 I/O 对此操作的影响,请参阅 DeviceIoControl 主题的“备注”部分。

在Windows 8和Windows Server 2012中,以下技术支持此代码。

技术 支持
服务器消息块 (SMB) 3.0 协议
SMB 3.0 透明故障转移 (TFO)
具有横向扩展文件共享的 SMB 3.0 (SO)
群集共享卷文件系统 (CSV)
弹性文件系统 (ReFS)

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 winioctl.h (包括 Windows.h)

另请参阅