MessageBeep 함수(winuser.h)
파형 소리를 재생합니다. 각 사운드 유형의 파형 소리는 레지스트리의 항목으로 식별됩니다.
참고 Windows Server 2022에서는 작업 스케줄러의 Microsoft\Windows\Multimedia\SystemSoundsService 작업을 사용할 수 없습니다. MessageBeep이 작동하려면 이 작업을 사용하도록 설정해야 합니다.
통사론
BOOL MessageBeep(
[in] UINT uType
);
매개 변수
[in] uType
재생할 소리입니다. 소리는 사운드 제어판 애플리케이션을 통해 사용자가 설정한 다음 레지스트리에 저장됩니다.
이 매개 변수는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
| 0xFFFFFFFF | 간단한 경고음. 사운드 카드를 사용할 수 없는 경우 스피커를 사용하여 소리가 생성됩니다. |
|
MB_ICONINFORMATION참조하세요. |
|
MB_ICONWARNING참조하세요. |
|
Windows Critical Stop 사운드로 지정된 소리입니다. |
|
MB_ICONERROR참조하세요. |
|
Windows 별표 소리로 지정된 소리입니다. |
|
Windows 질문 소리로 지정된 소리입니다. |
|
MB_ICONERROR참조하세요. |
|
Windows 느낌표로 지정된 소리입니다. |
|
Windows 기본 경고음으로 지정된 소리입니다. |
반환 값
함수가 성공하면 반환 값은 0이 아닌 값입니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.
발언
소리를 큐에 대기한 후 MessageBeep 함수는 호출 함수에 컨트롤을 반환하고 비동기적으로 소리를 재생합니다.
지정된 경고 소리를 재생할 수 없는 경우 MessageBeep 시스템 기본 소리를 재생하려고. 시스템 기본 소리를 재생할 수 없는 경우 함수는 경고음 함수를 사용하여 표준 경고음 소리를 생성합니다. Windows 7부터 기본 사운드 장치에서 간단한 톤을 재생합니다. 자세한 내용은 경고음 함수에 대한 설명서를 참조하세요.
사용자는 소리 제어판 애플리케이션을 사용하여 경고음을 사용하지 않도록 설정할 수 있습니다.
참고 원격 클라이언트에 경고음을 보내려면 경고음 함수를 사용합니다. Beep 함수는 클라이언트로 리디렉션되지만 MessageBeep 리디렉션되지 않습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
| API 집합 | ext-ms-win-ntuser-misc-l1-1-0(Windows 8에서 도입) |