WinStartApp

Execute a program.

Syntax
WinStartApp (notifyHndl, progDetails, progParams, reserved, flags)

Parameters

 * notifyHndl - HWND - input : The window notification handle or NULLHANDLE. If a window handle is passed, the system passes the WM_APPTERMINATENOTIFY message upon program exit.
 * progDetails - PROGDETAILS - input : The program list structure.
 * progParams - PSZ - input : NULL or the parameters for the program to be started. The layout is first, the program's exe name; the second, the space separated arguments.
 * reserved - PVOID - input : Start data. Reserved - pass NULL.


 * flags - ULONG - input : Zero for no flags or:
 * SAF_BACKGROUND
 * SAF_INSTALLEDCMDLINE
 * SAF_MAXIMIZED
 * SAF_MINIMIZED
 * SAF_STARTCHILDAPP

Constants
None

Returns
Possible returns from WinGetLastError:
 * HAPP : The invoked applications handle of this type.
 * NULLHANDLE : An error occurred.
 * PMERR_CANNOT_START
 * PMERR_DOS_ERROR
 * PMERR_INVALID_APPL
 * PMERR_INVALID_HWND
 * PMERR_INVALID_PARAMETERS
 * PMERR_INVALID_PROGRAM_CATEGORY
 * PMERR_INVALID_WINDOW
 * PMERR_STARTED_IN_BACKGROUND

Define (C/C++)
INCL_WINWINDOWMGR or INCL_WIN or INCL_PM

Calling Convention
Cdecl32

Example Code
HWND       notifyHndl; PROGDETAILS progDetails; PSZ        progParams; PVOID      reserved = NULL; ULONG      flags; HAPP       invokedHndl; ... // populate PROGDETAILS structure... ... invokedHndl = WinStartApp(notifyHndl, progDetails, progParams, reserved, flags); ...

Related Functions

 * WinQueryTaskSizePos
 * WinSetWindowPos
 * WinTerminateApp