Función ReleaseMutex (synchapi.h)
Libera la propiedad del objeto de exclusión mutua especificado.
Sintaxis
BOOL ReleaseMutex(
[in] HANDLE hMutex
);
Parámetros
[in] hMutex
Identificador del objeto de exclusión mutua. CreateMutex o
La función OpenMutex devuelve este identificador.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Se produce un error en la función ReleaseMutex si el subproceso que realiza la llamada no posee el objeto de exclusión mutua.
Un subproceso obtiene la propiedad de una exclusión mutua mediante su creación con el parámetro bInitialOwner establecido en TRUE o especificando su identificador en una llamada a una de las funciones de espera. Cuando el subproceso ya no necesita poseer el objeto de exclusión mutua, llama a la función ReleaseMutex para que otro subproceso pueda adquirir propiedad.
Un subproceso puede especificar una exclusión mutua que ya posee en una llamada a una de las funciones de espera sin bloquear su ejecución. Esto evita que un subproceso se interbloquee mientras espera una exclusión mutua que ya posee. Sin embargo, para liberar su propiedad, el subproceso debe llamar a ReleaseMutex una vez por cada vez que obtuvo la propiedad (ya sea a través de CreateMutex o una función de espera).
Ejemplos
Para obtener un ejemplo que usa ReleaseMutex, vea Using Mutex Objects.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | synchapi.h (incluye Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |