PWLX_MESSAGE_BOX 콜백 함수(winwlx.h)

아티클
08/28/2023

[Windows Server 2008 및 Windows Vista를 기준으로 WlxMessageBox 함수를 더 이상 사용할 수 없습니다.]

WlxMessageBox 함수는 메시지 상자를 만들고, 표시하고, 작동하기 위해 GINA에서 호출됩니다.

참고 GINA DLL은 Windows Vista에서 무시됩니다.

구문

PWLX_MESSAGE_BOX PwlxMessageBox;

int PwlxMessageBox(
  [in] HANDLE hWlx,
  [in] HWND hwndOwner,
  [in] LPWSTR lpszText,
  [in] LPWSTR lpszTitle,
  [in] UINT fuStyle
)
{...}

매개 변수

[in] hWlx

WlxInitialize 호출에서 GINA에 전달된 Winlogon 핸들을 지정합니다.

[in] hwndOwner

만들 메시지 상자의 소유자 창을 지정합니다. 이 매개 변수가 NULL이면 메시지 상자에 소유자 창이 없습니다.

[in] lpszText

표시할 메시지가 포함된 null로 끝나는 문자열을 가리킵니다.

[in] lpszTitle

대화 상자 제목에 사용되는 null로 끝나는 문자열을 가리킵니다. 이 매개 변수가 NULL이면 기본 제목 Error가 사용됩니다.

[in] fuStyle

대화 상자의 내용과 동작을 지정합니다. 이 매개 변수는 다음 값의 조합일 수 있습니다.

값	의미
MB_ABORTRETRYIGNORE	메시지 상자에는 중단, 다시 시도 및 무시라는 세 가지 명령 단추가 포함되어 있습니다.
MB_APPLMODAL	사용자는 hWndOwner 매개 변수로 식별된 창에서 작업을 계속하기 전에 메시지 상자에 응답해야 합니다. 그러나 사용자는 다른 애플리케이션의 창으로 이동하여 작업할 수 있습니다. 애플리케이션의 창 계층 구조에 따라 사용자는 애플리케이션 내의 다른 창으로 이동할 수 있습니다. 메시지 상자의 부모의 모든 자식 창은 자동으로 비활성화되지만 팝업 창은 비활성화되지 않습니다. MB_SYSTEMMODAL 또는 MB_TASKMODAL 지정되지 않은 경우 MB_APPLMODAL 기본값입니다.
MB_DEFAULT_DESKTOP_ONLY	현재 입력을 수신하는 데스크톱은 기본 데스크톱이어야 합니다. 그렇지 않으면 함수가 실패합니다. 기본 데스크톱은 사용자가 로그온한 후 애플리케이션이 실행되는 데스크톱입니다.
MB_DEFBUTTON1	첫 번째 단추가 기본 단추입니다. MB_DEFBUTTON2 또는 MB_DEFBUTTON3 지정하지 않는 한 첫 번째 단추는 항상 기본값입니다.
MB_DEFBUTTON2	두 번째 단추는 기본 단추입니다.
MB_DEFBUTTON3	세 번째 단추는 기본 단추입니다.
MB_DEFBUTTON4	네 번째 단추는 기본 단추입니다.
MB_ICONASTERISK	원 안에 소문자로 구성된 아이콘이 메시지 상자에 나타납니다.
MB_ICONEXCLAMATION	메시지 상자에 느낌표 아이콘이 나타납니다.
MB_ICONHAND	메시지 상자에 손 아이콘이 나타납니다.
MB_ICONINFORMATION	원 안에 소문자로 구성된 아이콘이 메시지 상자에 나타납니다.
MB_ICONQUESTION	메시지 상자에 물음표 아이콘이 나타납니다.
MB_ICONSTOP	메시지 상자에 중지 기호 아이콘이 나타납니다.
MB_OK	메시지 상자에는 하나의 명령 단추인 확인이 포함되어 있습니다.
MB_OKCANCEL	메시지 상자에는 확인 및 취소라는 두 개의 명령 단추가 포함되어 있습니다.
MB_RETRYCANCEL	메시지 상자에는 다시 시도 및 취소라는 두 개의 명령 단추가 포함되어 있습니다.
MB_SERVICE_NOTIFICATION	호출자는 이벤트의 사용자에 게 알리는 서비스. 이 함수는 컴퓨터에 로그온한 사용자가 없더라도 현재 활성 데스크톱에 메시지 상자를 표시합니다.
MB_SETFOREGROUND	메시지 상자가 포그라운드 창이 됩니다. 내부적으로 Windows는 메시지 상자에 대해 SetForegroundWindow 함수를 호출합니다.
MB_SYSTEMMODAL	모든 애플리케이션에는 사용자가 messagebox에 응답할 때까지 일시 중단 됩니다. 애플리케이션이 MB_ICONHAND 지정하지 않으면 메시지 상자가 만들어질 때까지 모달이 되지 않습니다. 따라서 소유자 창 및 기타 창은 활성화로 인한 메시지를 계속 받습니다. 시스템 모달 메시지 상자를 사용하여 사용자에게 즉각적인 주의가 필요한 심각하고 잠재적으로 손상될 수 있는 오류(예: 메모리 부족)를 알립니다.
MB_TASKMODAL	hWndOwner 매개 변수가 NULL인 경우 현재 작업에 속하는 모든 최상위 창이 비활성화된다는 점을 제외하고 MB_APPLMODAL 동일합니다. 호출하는 애플리케이션 또는 라이브러리에 사용 가능한 창 핸들이 없지만 다른 애플리케이션을 일시 중단하지 않고 현재 애플리케이션의 다른 창에 대한 입력을 방지해야 하는 경우 이 플래그를 사용합니다.
MB_YESNO	메시지 상자에는 예 및 아니요라는 두 개의 명령 단추가 포함되어 있습니다.
MB_YESNOCANCEL	메시지 상자에는 예, 아니요 및 취소라는 세 개의 명령 단추가 포함되어 있습니다.

반환 값

함수가 실패하거나 메모리가 부족하여 메시지 상자를 만들 수 없는 경우 반환 값은 0입니다.

함수가 성공하면 반환 값은 대화 상자에서 반환되는 다음 메뉴 항목 값 중 하나입니다.

참고 메시지 상자에 취소 단추가 있는 경우 ESC 키를 누르거나 취소 단추를 클릭하면 함수가 IDCANCEL 값을 반환합니다. 메시지 상자에 취소 단추가 없으면 ESC 를 눌러도 아무런 효과가 없습니다.

반환 코드	설명
IDABORT	중단 단추가 선택되었습니다.
IDCANCEL	취소 단추가 선택되었습니다.
IDIGNORE	무시 단추가 선택되었습니다.
IDNO	단추를 선택하지 않았습니다.
IDOK	확인 단추가 선택되었습니다.
IDRETRY	다시 시도 단추가 선택되었습니다.
IDYES	예 단추가 선택되었습니다.

설명

WlxMessageBox 함수는 SAS 이벤트를 처리하지 않으며 보안 대화 상자에 적합하지 않습니다. 보안 대화 상자에 WlxDialogBox, WlxDialogBoxIndirect 또는 WlxDialogBoxIndirectParam 함수를 사용합니다.

WlxMessageBox 는 Windows MessageBox 함수를 복제합니다. 이 함수를 사용하면 Winlogon이 대화 상자를 시간 초과할 수도 있다는 점을 제외합니다. 자세한 내용은 MessageBox를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winwlx.h