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 物件。

規格需求

另請參閱

CreateMutex

Mutex 物件

同步處理函式