WinTerminateApp (1.2)
◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
#define INCL_PMSHL
BOOL WinTerminateApp(happ);
HAPP happ; /* application handle */
The WinTerminateApp function terminates an application previously started
with the WinInstStartApp function.
Parameter Description
────────────────────────────────────────────────────────────────────────────
happ Identifies the application to terminate.
Return Value
The return value is TRUE if the application is terminated successfully or
NULL if an error occurs.
Errors
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
PMERR_INVALID_HAPP
PMERR_CANNOT_STOP
Comments
The application to terminate must have been started using the
WinInstStartApp function with the SAF_STARTCHILDAPP option specified.
If the specified application does not stop, this function returns TRUE. To
ensure that the application has terminated, the application calling
WinTerminateApp must wait for the appropriate message to be posted to the
window specified in the WinInstStartApp function.
See Also
WinInstStartApp
♦