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
 
HAPP WinInstStartApp(hini, hwndNotifyWindow, cNames, paszNames,
    pszCmdLine, pData, fsOption)
HINI hini;                /* initialization-file handle                 */
HWND hwndNotifyWindow;    /* notification-window handle                 */
USHORT cNames;            /* count of elements in the application array */
PSZ * paszNames;          /* identifier of application                  */
PSZ pszCmdLine;           /* input parameters for application           */
PVOID pData;              /* must be zero                               */
USHORT fsOptions;         /* option flags                               */
 
The WinInstStartApp function starts an installed application.
 
Parameter         Description
────────────────────────────────────────────────────────────────────────────
 
 
hini              Specifies the handle of the initialization file where the
                  application is found.
 
hwndNotifyWindow  Identifies the window to which a notification message
                  should be sent. If this parameter is NULL, no notification
                  message is sent.
 
cNames            Specifies the number of elements in the array pointed to
                  by the paszNames parameter. This value must be 1 or 2.
 
paszNames         Points to an array of pointers which, in turn, point to
                  strings that contain the name of the application and group
                  (if any) where the application is found. The first element
                  of the array points to the application name, the second to
                  the group name.
 
pszCmdLine        Points to the string that contains the command line to be
                  passed to the application.
 
pData             Reserved value; must be zero.
 
fsOptions         Specifies the options to be used to start the application.
                  This parameter can be one of the following values:
 
                  Value                 Meaning
                  ──────────────────────────────────────────────────────────
                  SAF_INSTALLEDCMDLINE  The command-line parameters in the
                                        Task List are used. Any parameters
                                        specified by pszCmdLine are
                                        ignored.
 
                  SAF_STARTCHILDAPP     The application is started as a
                                        child session of the session from
                                        which the WinInstStartApp function
                                        is called.
 
Return Value
 
The return value is a handle to the application started if the function is
successful or NULL if an error occurs.
 
Errors
 
Possible errors may be retrieved with the WinGetLastError function, and may
be one of the following:
 
     PMERR_INVALID_PARAMETERS
     PMERR_INVALID_APPL
     PMERR_INVALID_WINDOW
     PMERR_CANNOT_START
     PMERR_STARTED_IN_BACKGROUND
     PMERR_DOS_ERROR
     PMERR_NOT_ENOUGH_MEM
 
See Also
 
WinTerminateApp
 
                                      ♦