Fungsi ReleaseMutex (synchapi.h)

Merilis kepemilikan objek mutex yang ditentukan.

Sintaks

BOOL ReleaseMutex(
  [in] HANDLE hMutex
);

Parameter

[in] hMutex

Handel ke objek mutex. CreateMutex atau

Fungsi OpenMutex mengembalikan handel ini.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi ReleaseMutex gagal jika utas panggilan tidak memiliki objek mutex.

Utas mendapatkan kepemilikan mutex baik dengan membuatnya dengan parameter bInitialOwner diatur ke TRUE atau dengan menentukan handelnya dalam panggilan ke salah satu fungsi tunggu. Ketika utas tidak perlu lagi memiliki objek mutex, utas memanggil fungsi ReleaseMutex sehingga utas lain dapat memperoleh kepemilikan.

Utas dapat menentukan mutex yang sudah dimilikinya dalam panggilan ke salah satu fungsi tunggu tanpa memblokir eksekusinya. Ini mencegah utas dari kebuntuan itu sendiri sambil menunggu mutex yang sudah dimilikinya. Namun, untuk merilis kepemilikannya, utas harus memanggil ReleaseMutex satu kali untuk setiap kali memperoleh kepemilikan (baik melalui CreateMutex atau fungsi tunggu).

Contoh

Untuk contoh yang menggunakan ReleaseMutex, lihat Menggunakan Objek Mutex.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	synchapi.h (termasuk Windows.h pada Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

CreateMutex

Objek Mutex

Fungsi Sinkronisasi