Função ReleaseMutex (synchapi.h)

Libera a propriedade do objeto mutex especificado.

Sintaxe

BOOL ReleaseMutex(
  [in] HANDLE hMutex
);

Parâmetros

[in] hMutex

Um identificador para o objeto mutex. O CreateMutex ou

A função OpenMutex retorna esse identificador.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função ReleaseMutex falhará se o thread de chamada não possuir o objeto mutex.

Um thread obtém a propriedade de um mutex criando-o com o parâmetro bInitialOwner definido como TRUE ou especificando seu identificador em uma chamada para uma das funções de espera. Quando o thread não precisa mais possuir o objeto mutex, ele chama a função ReleaseMutex para que outro thread possa adquirir a propriedade.

Um thread pode especificar um mutex que ele já possui em uma chamada para uma das funções de espera sem bloquear sua execução. Isso impede que um thread se deadlocking enquanto aguarda um mutex que ele já possui. No entanto, para liberar sua propriedade, o thread deve chamar ReleaseMutex uma vez para cada vez que ele obteve a propriedade (por meio de CreateMutex ou de uma função de espera).

Exemplos

Para obter um exemplo que usa ReleaseMutex, consulte Usando objetos Mutex.

Requisitos

Confira também

Createmutex

Objetos Mutex

Funções de sincronização