18 сент. 2010 г.

WinMain

Функция WinMain вызывается системой как начальная точка входа в Win32-приложение.
int WINAPI WinMain(
    HINSTANCE hInstance,     // дескриптор текущего экземпляра приложения
    HINSTANCE hPrevInstance, // дескриптор предыдущего экземпляра приложения
    LPSTR lpCmdLine,      // указатель на командную строку
    int nCmdShow       // режим отображения окна
);
Параметры:
hInstanceДескриптор текущего экземпляра приложения.
hPrevInstanceДескриптор предыдущего экземпляра приложения. Для Win32-приложений значение этого параметра всегда равно NULL. Если вам необходимо определить, запущена ли другая копия приложения, создайте именованый мьютекс, используя функцию CreateMutex. Если функция GetLastError возвратит значение ERROR_ALREADY_EXISTS, значит, другая копия вашего приложения запущена (она создала мьютекс).
lpCmdLineАдрес нульзаканчивающейся строки, в которой содержится командная строка для приложения.
nCmdShowОпределяет, как будет отображатся окно. Может принимать одно из следующих значений:


Значение:
Назначение:

SW_HIDE  
Скрывает окно и активизирует другое окно.

SW_MINIMIZE  
Сворачивает даное окно и активизирует окно, которое находится на вершине системного списка.

SW_RESTORE  
Активизирует и отображает окно. Если окно свернуто или развернуто, Windows востанавливает его к первоначальным размерам и положению (то же самое, что и SW_SHOWNORMAL).

SW_SHOW  
Активизирует окно и отображает его с текущими размерами и положением.

SW_SHOWMAXIMIZED  
Активизирует окно и отображает его как развернутое окно.

SW_SHOWMINIMIZED  
Активизирует окно и отображает его как иконку (свернутым).

SW_SHOWMINNOACTIVE  
Отображает окно свернутым. Активное окно остается активным.

SW_SHOWNA  
Отображает окно в его текущем положении. Активное окно остается активным.

SW_SHOWNOACTIVATE  
Отображает окно в соответствии с его последними размерами и положением. Активное окно остается активным.

SW_SHOWNORMAL  
Активирует и отображает окно. Если окно свернуто или развернуто, Windows восстанавливает его размеры и положение (то же самое, что и SW_RESTORE).

Возвращаемые значения:
При успешном завершении, когда функция получает сообщение WM_QUIT, она должна вернуть код завершения, содержащийся в параметре wParam этого сообщения. Если функция завершается перед входом в цикл обработки сообщений, она должна вернуть 0.
Замечания:
WinMain инициирует приложение, отображает его главное окно, и затем входит в цикл обработки сообщений. Цикл сообщений завершается, когда получается сообщение WM_QUIT. В этой точке WinMain выходит из приложения, возвращая значение, полученное в параметре wParam сообщения WM_QUIT. Если WM_QUIT было получено как результат вызова функции PostQuitMessage, значение wParam – это значение параметра nExitCode функции PostQuitMessage.
Смотрите также:
CreateMutex, DispatchMessage, GetMessage, PostQuitMessage, TranslateMessage
в 17:51