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 |