다음을 통해 공유


MessageBeep 함수(winuser.h)

파형 소리를 재생합니다. 각 사운드 유형의 파형 소리는 레지스트리의 항목으로 식별됩니다.

 
참고 Windows Server 2022에서는 작업 스케줄러의 Microsoft\Windows\Multimedia\SystemSoundsService 작업을 사용할 수 없습니다. MessageBeep이 작동하려면 이 작업을 사용하도록 설정해야 합니다.

통사론

BOOL MessageBeep(
  [in] UINT uType
);

매개 변수

[in] uType

재생할 소리입니다. 소리는 사운드 제어판 애플리케이션을 통해 사용자가 설정한 다음 레지스트리에 저장됩니다.

이 매개 변수는 다음 값 중 하나일 수 있습니다.

의미
0xFFFFFFFF 간단한 경고음. 사운드 카드를 사용할 수 없는 경우 스피커를 사용하여 소리가 생성됩니다.
MB_ICONASTERISK
0x00000040L
MB_ICONINFORMATION참조하세요.
MB_ICONEXCLAMATION
0x00000030L
MB_ICONWARNING참조하세요.
MB_ICONERROR
0x00000010L
Windows Critical Stop 사운드로 지정된 소리입니다.
MB_ICONHAND
0x00000010L
MB_ICONERROR참조하세요.
MB_ICONINFORMATION
0x00000040L
Windows 별표 소리로 지정된 소리입니다.
MB_ICONQUESTION
0x00000020L
Windows 질문 소리로 지정된 소리입니다.
MB_ICONSTOP
0x00000010L
MB_ICONERROR참조하세요.
MB_ICONWARNING
0x00000030L
Windows 느낌표로 지정된 소리입니다.
MB_OK
0x00000000L
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에서 도입)

참고 항목

경고음

오류 처리 함수

FlashWindow

사용자에게 알리는