UnlockFile 函式 (fileapi.h)
解除鎖定開啟檔案中的區域。 解除鎖定區域可讓其他進程存取區域。
如需指定區域的替代方式，請使用 UnlockFileEx 函 式。
語法
BOOL UnlockFile(
[in] HANDLE hFile,
[in] DWORD dwFileOffsetLow,
[in] DWORD dwFileOffsetHigh,
[in] DWORD nNumberOfBytesToUnlockLow,
[in] DWORD nNumberOfBytesToUnlockHigh
);
參數
[in] hFile
檔案的控制碼，其中包含使用 LockFile鎖定的區域。 必須使用 GENERIC_READ 或 GENERIC_WRITE 存取權限來建立檔案控制代碼。 如需詳細資訊，請參閱 檔案安全性和存取權限。
[in] dwFileOffsetLow
檔案中起始位元組位移的低序字組開始位置。
[in] dwFileOffsetHigh
檔案中開始鎖定區域之起始位元組位移的高序字組。
[in] nNumberOfBytesToUnlockLow
要解除鎖定之位元組範圍長度的低序單字。
[in] nNumberOfBytesToUnlockHigh
要解除鎖定之位元組範圍長度的高序單字。
傳回值
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
當完成埠與檔案控制代碼相關聯時，此函式一律會同步運作，但可能不會將完成專案排入佇列。
解除鎖定檔案的區域會釋放先前取得的檔案鎖定。 要解除鎖定的區域必須完全符合現有的鎖定區域。 檔案的兩個相鄰區域無法分開鎖定，然後使用跨越兩個鎖定區域的單一區域解除鎖定。
如果進程以鎖定的檔案部分終止，或關閉具有未完成鎖定的檔案，則鎖定會由作業系統解除鎖定。 不過，作業系統解除鎖定所需的時間取決於可用的系統資源。 因此，建議您的程式在終止時，明確地解除鎖定它鎖定的所有檔案。 如果未這麼做，如果作業系統尚未解除鎖定這些檔案，存取這些檔案可能會遭到拒絕。
在 Windows 8 和 Windows Server 2012 中，下列技術支援此函式。
| 技術 | 支援 |
|---|---|
| 伺服器訊息區 (SMB) 3.0 通訊協定 | 是 |
| SMB 3.0 透明容錯移轉 (TFO) | 是 |
| 具有向外延展檔案共用的 SMB 3.0 (SO) | 是 |
| 叢集共用磁片區檔案系統 (CsvFS) | 是 |
| 彈性檔案系統 (ReFS) | 是 |
需求
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | fileapi.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |