WinMain

Funcţia WinMain este numit de sistem ca punct de intrare iniţială pentru o aplicaţie Win32 bazată pe.

int WINAPI WinMain ( HINSTANCE  hInstance, / / ocupa la instanţă curentHINSTANCEhPrevInstance, / / ocupa la instanţă anterioarăLPSTRlpCmdLine, / / cursorul în linia de comandăintnCmdShow / / afişează starea de fereastra);
 

Parametrii

hInstance

Mâner instanţă actuală a cererii.

hPrevInstance

Mâner instanţă anterioară aplicării. Pentru o aplicaţie Win32 bazate, acest parametru este întotdeauna NULL.

Dacă aveţi nevoie pentru a detecta dacă un alt exemplu există deja, creaţi un utilizând mutex unic numit CreateMutex funcţie. CreateMutex va reuşi, chiar dacă mutex există deja, dar GetLastError funcţia va întoarce ERROR_ALREADY_EXISTS. Acest lucru indică faptul că există o altă instanţă a aplicaţiei, deoarece a creat primul mutex.

lpCmdLine

Indicatorul la un şir null-terminated specificând linia de comandă de aplicare, cu excep?ia numele programului. Pentru a prelua întreaga linie de comandă, utilizaţi GetCommandLine funcţie.

nCmdShow

Specifică modul în fereastra este să fie afişate. Acest parametru poate fi una dintre următoarele valori:

Valoarea	Sensul
SW_HIDE	Ascunde fereastra şi activează o altă fereastră.
SW_MINIMIZE	Minimizează fereastra specificate şi activează fereastra nivel superior din lista a sistemului.
SW_RESTORE	Activează şi afişează o fereastră. Dacă fereastra este minimizată sau maximizată, sistemul se restabileşte original dimensiunea şi poziţia (la fel ca SW_SHOWNORMAL).
SW_SHOW	Activează o fereastră şi ea afişează dimensiunea actuală ?i pozi?ia.
SW_SHOWMAXIMIZED	Activează o fereastră şi se afişează ca o fereastră maximizată.
SW_SHOWMINIMIZED	Activează o fereastră şi se afişează ca o pictogramă.
SW_SHOWMINNOACTIVE	Afişează o fereastră ca pictogramă. Fereastra activă rămâne activă.
SW_SHOWNA	Afişează o fereastră în starea sa curentă. Fereastra activă rămâne activă.
SW_SHOWNOACTIVATE	Afişează o fereastră la dimensiunea şi poziţia cea mai recentă. Fereastra activă rămâne activă.
SW_SHOWNORMAL	Activează şi afişează o fereastră. Dacă fereastra este minimizată sau maximizată, sistemul se restabileşte original dimensiunea şi poziţia (la fel ca SW_RESTORE).

Valorile întroarse

Dacă funcţia reuşeşte, care se încheie atunci când primeşte un mesaj WM_QUIT, ar trebui să întoarce valoarea de ie?ire din acel mesaj wParam parametru. Dacă funcţia se termină înainte de a intra la bucla de mesaj, acesta trebuie să returnaţi zero.

Observaţii

Dumneavoastră WinMain ar trebui să ini?ializat aplica?ia, afişaţi fereastra sa principală, şi introduceţi o buclă de regăsire şi expediere mesaj care este structura de control de nivel superior pentru restul de executarea aplicaţiei. Termina bucla mesaj atunci când primeşte un mesaj de WM_QUIT. În acel moment, vă WinMain ar trebui să ieşi cererii, se întoarce valoarea trecut în WM_QUIT mesajului wParam parametru. Dacă WM_QUIT a fost primit ca urmare a PostQuitMessagede asteptare, valoarea wParam este valoarea parametru funcţia de PostQuitMessage nExitCode . Pentru mai multe informaţii, consultaţi crearea o buclă de mesaj.

Aplicaţii ANSI utilizaţi parametrul lpCmdLine al funcţiei WinMain pentru a accesa şirul de linie de comandă, cu excep?ia numele programului. Motivul pentru care WinMain nu se pot întoarce siruri de caractere Unicode este că lpCmdLine utilizează tipul de date LPSTR , nu LPTSTR tip. Funcţia de GetCommandLine pot fi folosite pentru a accesa siruri de caractere Unicode în linia de comandă, deoarece utilizează tipul de date LPTSTR.

Windows CE: Windows CE nu acceptă următoarele valori pentru parametrul nCmdShow

SW_MINIMIZE

SW_RESTORE

SW_SHOWMAXIMIZED

SW_SHOWMINIMIZED

SW_SHOWMINNOACTIVE

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winbase.h.
Import Biblioteca:Definite de utilizator.

A se vedea, de asemenea

Prezentare generală a Windows, fereastra Funcţii, CreateMutex, DispatchMessage, GetCommandLine, GetMessage, PostQuitMessage, TranslateMessage