unlockFileEx 函数 (fileapi.h)

项目
08/23/2023

解锁指定文件中的区域。此函数可以同步或异步运行。

语法

BOOL UnlockFileEx(
  [in]      HANDLE       hFile,
            DWORD        dwReserved,
  [in]      DWORD        nNumberOfBytesToUnlockLow,
  [in]      DWORD        nNumberOfBytesToUnlockHigh,
  [in, out] LPOVERLAPPED lpOverlapped
);

参数

[in] hFile

文件的句柄。必须使用 GENERIC_READ 或 GENERIC_WRITE 访问权限创建句柄。有关详细信息，请参阅文件安全和访问权限。

dwReserved

保留参数;必须为零。

[in] nNumberOfBytesToUnlockLow

要解锁的字节范围长度的低序部分。

[in] nNumberOfBytesToUnlockHigh

要解锁的字节范围长度的高阶部分。

[in, out] lpOverlapped

指向函数用于解锁请求的 OVERLAPPED 结构的指针。此结构包含解锁范围开头的文件偏移量。必须将 hEvent 成员初始化为有效的句柄或零。有关详细信息，请参阅同步和异步 I/O。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零或 NULL。要获得更多的错误信息，请调用 GetLastError。

注解

解锁文件的某个区域会释放以前获取的文件锁。要解锁的区域必须与现有的锁定区域完全对应。文件的两个相邻区域不能单独锁定，然后使用跨两个锁定区域的单个区域解锁。

在 CloseHandle 函数完成处理之前释放锁。

在 Windows 8 和 Windows Server 2012 中，此函数由以下技术支持。

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

要求


最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	fileapi.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll