WinMain

Die WinMain -Funktion wird vom System als erste Anlaufstelle für eine Win32-basierte Anwendung aufgerufen.

Int WINAPI WinMain) HINSTANCE  hInstance, / / handle auf aktuelle InstanzHINSTANCEhPrevInstance, / / handle auf vorherige InstanzLPSTRParent, / / Zeiger auf KommandozeileintHeight / / Status des Fensters anzeigen);
 

Parameter

hInstance
Auf die aktuelle Instanz der Anwendung behandeln.
hPrevInstance
Handle für die vorherige Instanz der Anwendung. Für eine Win32-basierte Anwendung ist dieser Parameter immer NULL.

Wenn Sie benötigen, um festzustellen, ob bereits eine andere Instanz vorhanden ist, Erstellen einer eindeutig benannten Mutex mit der verwalteten CreateMutex -Funktion. CreateMutex ist gelingen, selbst wenn der Mutex bereits vorhanden ist, aber die GetLastError -Funktion gibt zurück ERROR_ALREADY_EXISTS. Dies bedeutet, dass eine weitere Instanz der Anwendung vorhanden ist, weil es den Mutex erstellt.

parent
Zeiger auf eine auf Null endende Zeichenfolge die Befehlszeile für die Anwendung ohne den Programmnamen angeben. Um die gesamte Befehlszeile abzurufen, verwenden Sie die GetCommandLine -Funktion.
height
Gibt an, wie das Fenster angezeigt werden. Dieser Parameter kann eine der folgenden Werte sein:
Wert Bedeutung
SW_HIDE Blendet das Fenster und ein anderes Fenster aktiviert.
SW_MINIMIZE Minimiert das angegebene Fenster und aktiviert das Fenster das obersten Ebene in der Systemliste.
SW_RESTORE Aktiviert ein Fenster und zeigt. Wenn das Fenster minimiert oder maximiert ist, setzt das System es auf seine ursprüngliche Größe und Position (wie SW_SHOWNORMAL).
SW_SHOW Aktiviert ein Fenster und zeigt es in seiner aktuellen Größe und position.
SW_SHOWMAXIMIZED Aktiviert ein Fenster und zeigt es als maximiertes Fenster.
SW_SHOWMINIMIZED Aktiviert ein Fenster und zeigt es als Symbol.
SW_SHOWMINNOACTIVE Zeigt ein Fenster als Symbol. Das aktive Fenster bleibt aktiv.
SW_SHOWNA Zeigt ein Fenster im aktuellen Zustand. Das aktive Fenster bleibt aktiv.
SW_SHOWNOACTIVATE Zeigt das Fenster in seiner jüngsten Größe und Position. Das aktive Fenster bleibt aktiv.
SW_SHOWNORMAL Aktiviert ein Fenster und zeigt. Wenn das Fenster minimiert oder maximiert ist, setzt das System es auf seine ursprüngliche Größe und Position (wie SW_RESTORE).

Rückgabewerte

Wenn die Funktion erfolgreich ist, sollte beendet, wenn es eine WM_QUIT Nachricht empfängt es den Ausfahrt in die Nachricht wParam -Parameter enthaltenen Wert zurückgeben. Wenn die Funktion vor dem Eintritt in der Meldungsschleife beendet, sollte es NULL zurückgeben.

Bemerkungen

Ihre WinMain sollte die Anwendung initialisieren, sein Hauptfenster anzuzeigen, und geben Sie eine Meldungsschleife für Abruf und Versand, die das Steuerelement der obersten Ebene für den Rest der Ausführung der Anwendung ist. Beendet die Meldungsschleife, wenn es eine WM_QUIT Nachricht empfängt. An diesem Punkt sollten Ihre WinMain die Anwendung beendet wird in die WM_QUIT Nachricht wParam -Parameter übergebenen Wert zurückgeben. Wenn als Ergebnis eines Aufrufs PostQuitMessageWM_QUIT empfangen wurde, ist der Wert von wParam den Wert der nExitCode -Parameter der Funktion PostQuitMessage . Weitere Informationen finden Sie unter Erstellen einer Meldungsschleife.

ANSI-Anwendungen können den Parent -Parameter der WinMain -Funktion verwenden, um die Befehlszeile-Zeichenfolge, außer den Namen des Programms zugreifen. Der Grund, den dass WinMain Unicode-Zeichenfolgen zurückgeben kann ist, dass die Parent nicht der LPTSTR -Datentyp den Datentyp LPSTR verwendet. Die GetCommandLine -Funktion kann auf Unicode-Zeichenfolgen in der Befehlszeile verwendet werden, da es den LPTSTR -Datentyp verwendet.

Windows CE: Windows CE unterstützt nicht die folgenden Werte für den Height -parameter

SW_MINIMIZE

SW_RESTORE

SW_SHOWMAXIMIZED

SW_SHOWMINIMIZED

SW_SHOWMINNOACTIVE

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:Deklariert in winbase.h.
Importieren Bibliothek:Benutzerdefinierte.

Siehe auch

Übersicht über Windows, Fensterfunktionen, CreateMutex, DispatchMessage, GetCommandLine, PostQuitMessage, GetMessage, TranslateMessage