WinMain

WinMain funkciu nazýva systém ako počiatočné vstupný bod Win32 aplikačné.

WINAPI WinMain ( int HINSTANCE  hInstance; / / popisovača na aktuálnu inštanciuHINSTANCEhPrevInstance; / / zvládnuť predchádzajúca inštanciaUkončený nulou LPSTRlpCmdLine; / / ukazovateľ na príkazovom riadkuintnCmdShow / / show state okno);
 

Parametre

hInstance
Rukoväť na aktuálnu inštanciu uplatňovanie.
hPrevInstance
Popisovač predchádzajúca inštancia aplikácie. Pre aplikáciou Win32 založené tento parameter je vždy NULL.

Ak potrebujete zistiť, či iná inštancia už existuje, vytvoriť jednoznačne pomenované mutex pomocou príkaz CreateMutex funkcie. Príkaz CreateMutex podarí, dokonca aj vtedy, ak k mutexu zo už existuje, ale GetLastError funkcia vráti ERROR_ALREADY_EXISTS. To naznačuje, že existuje ďalšia inštancia vašej aplikácie, pretože vytvorené mutex najprv.

lpCmdLine
Smerník na reťazec zakončený špecifikujúce príkazového riadka pre aplikáciu, okrem názov programu. Chcete načítať celý príkazový riadok, použite GetCommandLine funkcia.
nCmdShow
Určuje, ako je okno uvádzať. Tento parameter môže byť jedna z nasledovných hodnôt:
Hodnota Význam
SW_HIDE Skryje okno a aktivuje iného okna.
SW_MINIMIZE Zadané okno minimalizuje a aktivuje okno najvyššej úrovne v systémový zoznam.
SW_RESTORE Aktivuje a zobrazí okno. Ak okno je minimalizované alebo maximalizované, systém obnoví sa jej pôvodná veľkosť a umiestnenie (rovnaké ako SW_SHOWNORMAL).
SW_SHOW Aktivuje okno a otvorí ju v jeho aktuálnu veľkosť a umiestnenie.
SW_SHOWMAXIMIZED Aktivuje okno a zobrazí ju v maximalizovanom okne.
SW_SHOWMINIMIZED Aktivuje okno a zobrazí ako ikona.
SW_SHOWMINNOACTIVE V okne sa zobrazí ako ikona. Aktívne okno zostáva aktívny.
SW_SHOWNA Zobrazí okno v jej súčasnom stave. Aktívne okno zostáva aktívny.
SW_SHOWNOACTIVATE Zobrazí okno v jej najnovšej veľkosť a umiestnenie. Aktívne okno zostáva aktívny.
SW_SHOWNORMAL Aktivuje a zobrazí okno. Ak okno je minimalizované alebo maximalizované, systém obnoví sa jej pôvodná veľkosť a umiestnenie (rovnaké ako SW_RESTORE).

Note:

Ak funkciu podarí, ukončuje keď obdrží správu WM_QUIT to by mal vrátiť výstupné hodnoty obsiahnuté v tejto správe wParam parameter. Ak funkciu ukončí pred vstupom do správy vedenia, by sa mali vrátiť nulový.

Poznámky

Vaša WinMain by inicializáciu aplikácie, jej hlavné okno a zadajte správy vyhľadávania a odoslania slučky, ktorá je najvyššej úrovne kontrolné štruktúry pre zvyšok vykonanie aplikácie. Ukončiť správu vedenia keď obdrží správu WM_QUIT. Vaše WinMain v tomto bode by mala skončiť aplikáciu, vracajúci hodnota odovzdaná v správe WM_QUIT wParam parameter. Ak WM_QUIT bola prijatá v volá PostQuitMessage, hodnota wParam je hodnota nExitCode parameter PostQuitMessage funkcie. Ďalšie informácie nájdete v téme vytváranie správ slučky.

Aplikácie ANSI môžete použiť parameter lpCmdLine funkcie WinMain prístup k reťazci príkazového riadka s výnimkou názov programu. Dôvodom, prečo sa WinMain nemôže vrátiť reťazcov Unicode je, že lpCmdLine používa typ údajov ukončený nulou LPSTR nie LPTSTR údajový typ. GetCommandLine funkcia môže používaný na prístup k reťazcov Unicode v príkazovom riadku, pretože používa typ údajov LPTSTR.

Windows CE: Windows CE nepodporuje nasledovné hodnoty parametra nCmdShow

SW_MINIMIZE

SW_RESTORE

SW_SHOWMAXIMIZED

SW_SHOWMINIMIZED

SW_SHOWMINNOACTIVE

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Vyžaduje verziu 1.0 alebo novšiu verziu.
Hlavičky:Deklarovaný v winbase.h.
Importovať knižnica:Definované používateľom.

Pozri tiež

Windows prehľad, okno funkcie, príkaz CreateMutex, DispatchMessage, GetCommandLine, GetMessage, PostQuitMessage, TranslateMessage