WinTerminateApp

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