WinTerminateApp

WinTerminateApp

WinTerminateApp(appHndl)

Terminates a program started with WinStartApp.

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 conversion

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.

OS Version Introduced

Back to OS/2 API