Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                      ◄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
 
                                      ♦