Condividi tramite


Funzione ReleaseMutex (synchapi.h)

Rilascia la proprietà dell'oggetto mutex specificato.

Sintassi

BOOL ReleaseMutex(
  [in] HANDLE hMutex
);

Parametri

[in] hMutex

Handle per l'oggetto mutex. CreateMutex o

La funzione OpenMutex restituisce questo handle.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione ReleaseMutex ha esito negativo se il thread chiamante non è proprietario dell'oggetto mutex.

Un thread ottiene la proprietà di un mutex creandolo con il parametro bInitialOwner impostato su TRUE o specificando il relativo handle in una chiamata a una delle funzioni di attesa. Quando il thread non deve più possedere l'oggetto mutex, chiama la funzione ReleaseMutex in modo che un altro thread possa acquisire la proprietà.

Un thread può specificare un mutex di cui è già proprietario in una chiamata a una delle funzioni di attesa senza bloccarne l'esecuzione. Ciò impedisce a un thread di bloccarsi durante l'attesa di un mutex già proprietario. Tuttavia, per rilasciarne la proprietà, il thread deve chiamare ReleaseMutex una volta per ogni volta che ha ottenuto la proprietà (tramite CreateMutex o una funzione di attesa).

Esempio

Per un esempio che usa ReleaseMutex, vedere Uso di oggetti Mutex.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione synchapi.h (include Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

CreateMutex

Oggetti Mutex

Funzioni di sincronizzazione