PostQuitMessage-Funktion (winuser.h)

Artikel
03/04/2024

Gibt dem System an, dass ein Thread eine Anforderung zum Beenden (Beenden) gestellt hat. Sie wird in der Regel als Reaktion auf eine WM_DESTROY-Nachricht verwendet.

Syntax

void PostQuitMessage(
  [in] int nExitCode
);

Parameter

[in] nExitCode

Typ: int

Der Anwendungsausgangscode. Dieser Wert wird als wParam-Parameter der WM_QUIT-Nachricht verwendet.

Rückgabewert

Keine

Bemerkungen

Die PostQuitMessage-Funktion sendet eine WM_QUIT Nachricht in die Nachrichtenwarteschlange des Threads und gibt sofort zurück. Die -Funktion gibt dem System einfach an, dass der Thread zu einem bestimmten Zeitpunkt in der Zukunft beendet werden soll.

Wenn der Thread die WM_QUIT Nachricht aus seiner Nachrichtenwarteschlange abruft, sollte er seine Nachrichtenschleife beenden und die Steuerung an das System zurückgeben. Der an das System zurückgegebene Exitwert muss der wParam-Parameter der WM_QUIT Meldung sein.

Beispiele

Ein Beispiel finden Sie unter Posten einer Nachricht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-message-l1-1-0 (eingeführt in Windows 8)