WinTerminateApp: Difference between revisions

Revision as of 17:01, 8 February 2020

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);
...

Related Functions

WinStartApp

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.

@@ Line 31: / Line 31: @@
 === Notes ===
-This function works only if [[SAF#SAF_STARTCHILDAPP|SAF_STARTCHILDAPP]] is specified at program start. The notify window handle specified in [[WinStartApp]] will receive the '''WM_APPTERMINATENOTIFY''' message.
+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.
 [[Category:Win]]