ReleaseMutex 函式 (synchapi.h)

釋放指定 Mutex 物件的擁有權。

語法

BOOL ReleaseMutex(
  [in] HANDLE hMutex
);

[in] hMutex

Mutex 物件的句柄。 CreateMutex 或

OpenMutex 函式會傳回此句柄。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

如果呼叫線程沒有擁有 mutex 物件， ReleaseMutex 函式就會失敗。

線程會建立 mutex 的擁有權，方法是使用設定為 TRUE 的 bInitialOwner 參數建立 Mutex，或在呼叫其中一個等候函式中指定其句柄。當線程不再需要擁有 mutex 物件時，它會呼叫 ReleaseMutex 函式，讓另一個線程可以取得擁有權。

線程可以指定已在呼叫其中一個等候函式中擁有的 mutex，而不會封鎖其執行。這可防止線程在等候已擁有的 Mutex 時，自行死結。不過，若要釋放其擁有權，線程必須在每次透過 CreateMutex 或 wait) 函式取得擁有 (權時呼叫 ReleaseMutex 一次。

如需使用 ReleaseMutex 的範例，請參閱使用 Mutex 物件。

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	synchapi.h (Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2)
程式庫	Kernel32.lib
DLL	Kernel32.dll