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 |
참고 항목
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기