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

HAPP

The invoked applications handle of this type.

NULLHANDLE

An error occurred.

Possible returns from WinGetLastError:

• 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

Notes

Specifying SAF_STARTCHILDAPP flag, the newly invoked program can be stopped with WinTerminateApp.