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

Vedere anche

CreateMutex

Oggetti Mutex

Funzioni di sincronizzazione