WinMain

WinMain işlevi sistem tarafından Win32 tabanlı bir uygulama için ilk giriş noktası olarak adlandırılır.

int WINAPI WinMain ((İngilizce) HINSTANCE  HINSTANCE, / / işlemek için geçerli örneğiHINSTANCEhPrevInstance, / / ele önceki örneğilpstrlpCmdLine, / / komut satırı işaretçisineintnCmdShow / / pencerenin durumu göster);
 

Parametreleri

hINSTANCE

Geçerli uygulama örneği için tanıtıcı.

hPrevInstance

Uygulamanın önceki örneği için tanıtıcı. Win 32 tabanlı bir uygulama için bu parametreyi her zaman null.

Başka bir örneği zaten var olup olmadığını algılamak gerekirse, bir benzersiz olarak adlandırılmış mutex kullanarak oluşturduğunuz CreateMutex işlevi. CreateMutex bile, zaman uyumu sağlayıcısı zaten başarılı olur ama GetLastError işlevini ERROR_ALREADY_EXISTS dönecektir. O ilk mutex oluşturduğundan bu uygulamanın başka bir örneği olduğunu gösterir.

lpCmdLine

Komut satırında program adı hariç uygulama belirten bir boş sonlandırılmış dize işaretçisi. Tüm komut satırı almak için GetCommandLine işlevi.

nCmdShow

Nasıl pencere gösterilmesini belirtir. Bu parametre aşağıdaki değerlerden biri olabilir:

Değer	Anlamı
SW_HIDE	Pencereyi gizler ve başka bir pencereyi etkinleştirir.
SW_MINIMIZE	Belirtilen pencereyi simge durumuna küçültür ve sistemin listesinde üst pencereyi etkinleştirir.
SW_RESTORE	Etkinleştirir ve bir pencere görüntüler. Pencere simge durumuna küçültülmüş veya ekranı kaplamış, sistem bu orijinal boyutunda ve pozisyon (sw_shownormal ile aynı) yükler.
SW_SHOW	Bir pencereyi etkinleştirir ve onun geçerli boyutunu ve konumunu görüntüler.
SW_SHOWMAXIMIZED	Bir pencereyi etkinleştirir ve kaplamış görüntüler.
SW_SHOWMINIMIZED	Bir pencereyi etkinleştirir ve simge olarak görüntüler.
SW_SHOWMINNOACTIVE	Pencere simge olarak görüntülenir. Etkin pencere etkin olarak kalır.
SW_SHOWNA	Pencere, geçerli durumunu görüntüler. Etkin pencere etkin olarak kalır.
SW_SHOWNOACTIVATE	Bir pencere onun en son boyutu ve konumunu görüntüler. Etkin pencere etkin olarak kalır.
SW_SHOWNORMAL	Etkinleştirir ve bir pencere görüntüler. Pencere simge durumuna küçültülmüş veya ekranı kaplamış, sistem bu orijinal boyutunda ve pozisyon (sw_restore ile aynı) yükler.

Dönüş değerleri

İşlev başarılı olursa, bir WM_QUIT iletisi aldığında sonlandırma o bu iletinin wParam parametresinde bulunan çıkış değer döndürmelidir. İşlevi ileti döngüsü girmeden önce sona ererse, sıfır döndürmelidir.

Açıklamalar

Senin WinMain , onun ana penceresini görüntüler ve üst düzey denetim yapısı uygulamanın yürütme geri kalanı için bir ileti alma ve gönderme döngü girin uygulamayı başlatmak gerekir. WM_QUIT ileti aldığında ileti döngüsü sona erdirir. Bu noktada da WinMain WM_QUIT ileti wParam parametresinde geçirilen değer döndüren uygulama çıkmak. WM_QUIT PostQuitMessagearama sonucu alındıysa, wParam PostQuitMessage işlevin nExitCode parametre değeri değeridir. Daha fazla bilgi için bkz: ileti döngüsü oluşturma.

ANSI uygulamaları WinMain işlevi lpCmdLine parametresi hariç program adını komut satırı dizesi erişmek için kullanabilirsiniz. WinMain Unicode dizeleri döndüremez sebebi bu lpCmdLine lpstr veri türü değil lptstr veri türü kullanılır. Komut satırı, Unicode dizelerini erişmek için lptstr veri türünü kullanır çünkü GetCommandLine işlevi kullanılabilir.

Windows ce: Windows ce nCmdShow parametresi için aşağıdaki değerleri desteklemiyor

SW_MINIMIZE

SW_RESTORE

SW_SHOWMAXIMIZED

SW_SHOWMINIMIZED

SW_SHOWMINNOACTIVE

QuickInfo

nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Sürüm 1.0 veya daha ilerisini gerektirir.
Header:Winbase.h ilan etti.
İçe Library:Kullanıcı tanımlı.

Ayrıca bkz:

Windows genel bakış, pencere işlevleri, CreateMutex, DispatchMessage, GetCommandLine GetMessage, PostQuitMessage, TranslateMessage