共用方式為


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_READGENERIC_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