ReleaseMutex 함수(synchapi.h)

지정된 뮤텍스 개체의 소유권을 해제합니다.

구문

BOOL ReleaseMutex(
  [in] HANDLE hMutex
);

매개 변수

[in] hMutex

뮤텍스 개체에 대한 핸들입니다. CreateMutex 또는

OpenMutex 함수는 이 핸들을 반환합니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

호출 스레드가 뮤텍스 개체를 소유하지 않으면 ReleaseMutex 함수가 실패합니다.

스레드는 bInitialOwner 매개 변수를 TRUE 로 설정하여 만들거나 대기 함수 중 하나에 대한 호출에서 해당 핸들을 지정하여 뮤텍스의 소유권을 얻습니다. 스레드가 더 이상 뮤텍스 개체를 소유할 필요가 없는 경우 다른 스레드가 소유권을 획득할 수 있도록 ReleaseMutex 함수를 호출합니다.

스레드는 실행을 차단하지 않고 대기 함수 중 하나에 대한 호출에서 이미 소유하고 있는 뮤텍스를 지정할 수 있습니다. 이렇게 하면 이미 소유하고 있는 뮤텍스를 기다리는 동안 스레드가 교착 상태가 발생하지 않습니다. 그러나 소유권을 해제하려면 스레드가 소유권을 가져올 때마다 (CreateMutex 또는 대기 함수를 통해) ReleaseMutex 를 한 번 호출해야 합니다.

예제

ReleaseMutex를 사용하는 예제는 뮤텍스 개체 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	synchapi.h(Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2에 Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

CreateMutex

뮤텍스 개체

동기화 함수