WinMain 함수(winbase.h)
그래픽 Windows 기반 애플리케이션에 대한 사용자가 제공한 진입점입니다.
WinMain 애플리케이션 진입점에 사용되는 기존 이름입니다. 자세한 내용은 비고를 참조하세요.
통사론
int __clrcall WinMain(
[in] HINSTANCE hInstance,
[in, optional] HINSTANCE hPrevInstance,
[in] LPSTR lpCmdLine,
[in] int nShowCmd
);
매개 변수
[in] hInstance
형식: HINSTANCE
애플리케이션의 현재 인스턴스에 대한 핸들입니다.
[in, optional] hPrevInstance
형식: HINSTANCE
애플리케이션의 이전 인스턴스에 대한 핸들입니다. 이 매개 변수는 항상 NULL
[in] lpCmdLine
형식: LPSTR
프로그램 이름을 제외한 애플리케이션에 대한 명령줄입니다. 전체 명령줄을 검색하려면 GetCommandLine 함수를 사용합니다.
[in] nShowCmd
형식: int
창을 표시하는 방법을 제어합니다. 이 매개 변수는 ShowWindow 함수에 대한 nCmdShow 매개 변수에 지정할 수 있는 값일 수 있습니다.
반환 값
형식: int
함수가 성공하고 WM_QUIT 메시지를 받으면 종료되면 해당 메시지의 wParam 매개 변수에 포함된 종료 값을 반환해야 합니다. 메시지 루프를 입력하기 전에 함수가 종료되면 0을 반환해야 합니다.
발언
WinMain
WinMain 애플리케이션을 초기화하고, 주 창을 표시하고, 애플리케이션 실행의 나머지 부분에 대한 최상위 제어 구조인 메시지 검색 및 디스패치 루프를 입력해야 합니다. WM_QUIT 메시지를 받으면 메시지 루프를 종료합니다. 이때 WinMain 애플리케이션을 종료하고 WM_QUIT 메시지의 wParam 매개 변수에 전달된 값을 반환해야 합니다. PostQuitMessage호출한 결과로 WM_QUIT 수신된 경우 wParam 값은 PostQuitMessage 함수의 nExitCode 매개 변수 값입니다. 자세한 내용은 메시지 루프만들기를 참조하세요.
ANSI 애플리케이션은 WinMain 함수의 lpCmdLine 매개 변수를 사용하여 프로그램 이름을 제외한 명령줄 문자열에 액세스할 수 있습니다. lpCmdLineLPTSTR 데이터 형식 대신 LPSTR 데이터 형식을 사용합니다. 즉, WinMain 유니코드 프로그램에서 사용할 수 없습니다. GetCommandLineW 함수를 사용하여 명령줄을 유니코드 문자열로 가져올 수 있습니다. 일부 프로그래밍 프레임워크는 유니코드 명령줄을 제공하는 대체 진입점을 제공할 수 있습니다. 예를 들어 Microsoft Visual Studio C++ 규격은 유니코드 진입점에 wWinMain
본보기
다음 코드 예제에서는 winMain
#include <windows.h>
int APIENTRY WinMain(HINSTANCE hInst, HINSTANCE hInstPrev, PSTR cmdline, int cmdshow)
{
return MessageBox(NULL, "hello, world", "caption", 0);
}
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winbase.h(Windows.h 포함) |
참고 항목
개념
CreateMutex
GetCommandLine
GetMessage
기타 리소스
참조
windows