WinTerminateApp: Difference between revisions

Latest revision as of 18:58, 14 May 2025

Terminates a program started with WinStartApp.

WinTerminateApp(appHndl)

Parameters

appHndl - HAPP - input: The application handle as returned by WinStartApp.

Returns

Returns BOOL:

TRUE
FALSE

Possible error codes from WinGetLastError:

PMERR_INVALID_HAPP
PMERR_CANNOT_STOP

Define (C/C++)

INCL_WINWINDOWMGR or INCL_WIN or INCL_PM

Calling Convention

Cdecl32

Example Code

HAPP    appHndl;
BOOL    rc;
...
rc = WinTerminateApp(appHndl);
...

Notes

This function works only if SAF_STARTCHILDAPP is specified at program start. The notify window handle specified in WinStartApp will receive the WM_APPTERMINATENOTIFY message.

This function must be called from the same process that called WinStartApp.

This function requires the existence of a message queue on the calling thread.

Related Functions

WinStartApp

@@ Line 2: / Line 2: @@
   WinTerminateApp(appHndl)
-=== Parameters ===
+== Parameters ==
 ;appHndl - [[HAPP]] - input : The application handle as returned by WinStartApp.
-=== Returns ===
+==Returns ==
 Returns [[BOOL]]:
 * [[TRUE]]
@@ Line 14: / Line 14: @@
 * PMERR_CANNOT_STOP
-=== Define (C/C++) ===
+== Define (C/C++) ==
 INCL_WINWINDOWMGR or INCL_WIN or INCL_PM
-=== Calling Convention ===
+== Calling Convention ==
 [[Cdecl32]]
-=== Example Code ===
+== Example Code ==
   HAPP    appHndl;
   BOOL    rc;
@@ Line 26: / Line 26: @@
   rc = WinTerminateApp(appHndl);
   ...
-=== Related Functions ===
-*[[WinStartApp]]
 === Notes ===
 This function works only if [[SAF|SAF_STARTCHILDAPP]] is specified at program start. The notify window handle specified in [[WinStartApp]] will receive the '''WM_APPTERMINATENOTIFY''' message.
 This function must be called from the same process that called WinStartApp.
 This function requires the existence of a message queue on the calling thread.
+==Related Functions ==
+*[[WinStartApp]]
 [[Category:Win]]