WaitMessage 함수(winuser.h)

  • 아티클

스레드에 메시지 큐에 다른 메시지가 없는 경우 다른 스레드에 대한 제어를 생성합니다. WaitMessage 함수는 스레드를 일시 중단하고 새 메시지가 스레드의 메시지 큐에 배치될 때까지 반환되지 않습니다.

구문

BOOL WaitMessage();

반환 값

형식: BOOL

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

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

설명

스레드가 큐를 검사 함수를 호출한 후 메시지 큐에 읽지 않은 입력이 있으면 WaitMessage가 반환되지 않습니다. PeekMessage, GetMessage, GetQueueStatus, WaitMessage, MsgWaitForMultipleObjects 및 MsgWaitForMultipleObjectsEx와 같은 함수가 큐를 검사 입력이 더 이상 새로운 것으로 간주되지 않도록 큐의 상태 정보를 변경하기 때문입니다. WaitMessage에 대한 후속 호출은 지정된 형식의 새 입력이 도착할 때까지 반환되지 않습니다. 스레드가 큐를 마지막으로 검사하기 전에 받은 기존 읽지 않은 입력은 무시됩니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 winuser.h(Windows.h 포함)
라이브러리 User32.lib
DLL User32.dll
API 세트 ext-ms-win-ntuser-window-l1-1-4(Windows 10 버전 10.0.14393에 도입됨)

추가 정보

개념

GetMessage

메시지 및 메시지 큐

PeekMessage

참조