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

另請參閱

鎖定和解除鎖定檔案中的位元組範圍

CreateFile

檔案管理功能

LockFile

UnlockFileEx