ShellMessageBoxA 함수(shellapi.h)

[ShellMessageBox 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

ShellMessageBox는 메시지 상자의 제목으로 소유자 창의 제목을 사용하는 옵션을 제공하는 MessageBox의 특별한 instance.

구문

int ShellMessageBoxA(
  [in] HINSTANCE hAppInst,
  [in] HWND      hWnd,
  [in] LPCSTR    lpcText,
  [in] LPCSTR    lpcTitle,
  [in] UINT      fuStyle,
       ...       
);

매개 변수

[in] hAppInst

형식: HINSTANCE

pszTitle에서 라는 문자열 리소스를 로드할 모듈의 핸들입니다. pszTitle이 문자열 리소스의 이름을 지정하지 않으면 이 매개 변수는 무시됩니다. pszMsg 또는 pszTitle이 리소스 ID인 경우 이 값은 유효해야 합니다.

[in] hWnd

형식: HWND

만들 메시지 상자의 소유자 창에 대한 핸들입니다. 이 변수가 NULL이 아니면 소유자 창의 제목이 메시지 상자의 제목으로 사용됩니다.

[in] lpcText

형식: LPCTSTR

표시할 메시지 또는 메시지를 검색할 위치를 지정하는 리소스 ID가 포함된 null로 끝나는 문자열에 대한 포인터입니다.

[in] lpcTitle

형식: LPCTSTR

대화 상자 제목 또는 제목을 검색할 위치를 지정하는 리소스 ID가 포함된 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수와 hWnd 가 모두 NULL이면 제목이 표시되지 않습니다. 이 매개 변수가 MAKEINTRESOURCE 매크로로 구성된 로드 가능한 리소스를 가리키는 경우 hWnd 를 제목으로 재정의합니다.

[in] fuStyle

형식: UINT

대화 상자의 내용과 동작을 지정합니다. 가능한 값은 MessageBox를 참조하세요.

...

pszMsg와 결합하여 메시지 상자에 표시되는 전체 텍스트를 형성하는 변수 인수 목록입니다.

반환 값

형식: int

메시지 상자에서 누른 단추를 나타내는 정수 값입니다. 특정 값은 MessageBox를 참조하세요.

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

설명

참고

shellapi.h 헤더는 SHELLMessageBox를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shellapi.h
라이브러리	Shlwapi.lib
DLL	Shlwapi.dll

추가 정보

MAKEINTRESOURCE

MessageBox