WinMain

WinMain -funksjonen kalles av systemet som første inngangspunkt for en Win32-basert program.

int WINAPI WinMain) HINSTANCE  hInstance, / / håndtere til gjeldende forekomstHINSTANCEhPrevInstance, / / håndtere til forrige forekomstLPSTRlpCmdLine, / / peker til kommandolinjenIntnCmdShow / / Vis tilstand av vinduet);
 

Parametere

hInstance

Håndtere til den gjeldende forekomsten av programmet.

hPrevInstance

Håndtere til forrige forekomst av programmet. For en Win32-basert program er denne parameteren alltid NULL.

Hvis du trenger å oppdage om en annen forekomst allerede finnes, kan du opprette en mutex som unike navn ved hjelp av den CreateMutex -funksjonen. CreateMutex vil lykkes selv om mutexen finnes allerede, men den GetLastError -funksjonen vil returnere ERROR_ALREADY_EXISTS. Dette angir at det finnes en annen forekomst av programmet, fordi det opprettet mutexen først.

lpCmdLine

Pekeren til en null-terminert streng som angir kommandolinjen for programmet, unntatt programnavnet. Hvis du vil hente hele kommandolinjen, bruker den GetCommandLine -funksjonen.

nCmdShow

Angir hvordan vinduet skal vises. Denne parameteren kan være en av følgende verdier:

Verdi	Betydning
SW_HIDE	Skjuler vinduet og aktiverer et annet vindu.
SW_MINIMIZE	Minimerer det angitte vinduet og aktiverer vinduet på øverste nivå i systemets-listen.
SW_RESTORE	Aktiverer og viser et vindu. Hvis vinduet er minimert eller maksimert, gjenoppretter systemet det til sin opprinnelige størrelse og plassering (samme som SW_SHOWNORMAL).
SW_SHOW	Aktiverer et vindu og viser den i sin nåværende størrelse og posisjon.
SW_SHOWMAXIMIZED	Aktiverer et vindu og viser det som et maksimert vindu.
SW_SHOWMINIMIZED	Aktiverer et vindu og viser den som et ikon.
SW_SHOWMINNOACTIVE	Viser et vindu som et ikon. Det aktive vinduet forblir aktiv.
SW_SHOWNA	Viser et vindu i gjeldende tilstand. Det aktive vinduet forblir aktiv.
SW_SHOWNOACTIVATE	Viser et vindu i de siste størrelsen og plasseringen. Det aktive vinduet forblir aktiv.
SW_SHOWNORMAL	Aktiverer og viser et vindu. Hvis vinduet er minimert eller maksimert, gjenoppretter systemet det til sin opprinnelige størrelse og plassering (samme som SW_RESTORE).

Returverdier

Hvis funksjonen lykkes, skal avslutter når den mottar en melding i WM_QUIT, det returnere Avslutt verdien i denne meldingen wParam parameteren. Hvis funksjonen avslutter før du skriver inn meldingen løkken, den egentlig skal returnere null.

Merknader

Din WinMain bør initialisere programmet, vise sin hovedvinduet, og angi en meldingsløkke for henting og levering er på øverste nivå kontrollstruktur for resten av kjøring av programmets. Avslutte meldingsløkke når den mottar en WM_QUIT-melding. Da, bør din WinMain avslutte programmet, returnerer verdien som ble sendt i meldingen WM_QUIT wParam -parameteren. Hvis WM_QUIT ble mottatt som et resultat av ringer PostQuitMessage, er verdien av wParam verdien av funksjonen PostQuitMessage nExitCode -parameteren. Hvis du vil ha mer informasjon, se opprette en meldingsløkke.

ANSI-programmer kan bruke parameteren lpCmdLine WinMain -funksjonen til å få tilgang til kommandolinjestreng, unntatt programnavnet. Grunnen til at WinMain ikke kan returnere Unicode-strenger er at lpCmdLine bruker datatypen LPSTR , ikke LPTSTR datatypen. Funksjonen GetCommandLine kan brukes til å få tilgang til Unicode-strenger i kommandolinjen, fordi den bruker datatypen LPTSTR.

Windows CE: Windows CE støtter ikke følgende verdier for parameteren nCmdShow

SW_MINIMIZE

SW_RESTORE

SW_SHOWMAXIMIZED

SW_SHOWMINIMIZED

SW_SHOWMINNOACTIVE

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winbase.h.
Importere biblioteket:Brukerdefinerte.

Se også

Oversikt over Windows, vinduet funksjoner, CreateMutex, DispatchMessage, GetCommandLine, GetMessage, PostQuitMessage, TranslateMessage