winbase.h


ReleaseMutex

La función ReleaseMutex

libera la propiedad del objeto mutex especificado.

Sintaxis

BOOL ReleaseMutex(
    HANDLE hMutex 	// manipulador de objeto mutex
   );

Parámetros

hMutex
Identifica el objeto mutex. Este manipulador es retornado por las funciones {wfCreateMutex} o OpenMutex.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

La función ReleaseMutex falla si el hilo que la llama no posee el objeto mutex.

Un hilo obtiene la propiedad de un mutex especificando un manipulador del mutex en una de las funciones de espera. El hilo que crea un objeto mutex puede también obtener la propiedad de forma inmediata sin usar una de las funciones de espera. Cuando el hilo propietario ya no necesite el objeto mutex, llamará a la función ReleaseMutex.

Mientras un hilo tiene la propiedad de un mutex, puede especificar el mismo mutex en llamadas adicionales a funciones de espera sin bloquear su ejecución. Esto evita que un hilo se bloquee a si mismo mientras espera por un mutex que ya posee. Sin embargo, para liberar su propiedad, el hilo debe llamar a ReleaseMutex una vez por cada una que el mutex haya satisfecho una espera.