WinStartApp: Difference between revisions

Revision as of 07:54, 19 February 2006

WinStartApp

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

Execute a program.

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:

Constants

None

Returns

The invoked applications handle of type HAPP, or NULLHANDLE if an error occurred. Possible returns from WinGetLastError:

Module

Define (C/C++)

INCL_WINWINDOWMGR or INCL_WIN or INCL_PM

Export name/Ordinal

Calling conversion

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

@@ Line 31: / Line 31: @@
 Possible returns from [[OS2 API:WinGetLastError|WinGetLastError]]:
 * [[OS2 API:PMI:error#PMERR_CANNOT_START|PMERR_CANNOT_START]]
+* [[OS2 API:PMI:error#PMERR_DOS_ERROR|PMERR_DOS_ERROR]]
 * [[OS2 API:PMI:error#PMERR_INVALID_APPL|PMERR_INVALID_APPL]]
 * [[OS2 API:PMI:error#PMERR_INVALID_HWND|PMERR_INVALID_HWND]]
+* [[OS2 API:PMI:error#PMERR_INVALID_PARAMETERS|PMERR_INVALID_PARAMETERS]]
 * [[OS2_API:PMI:error#PMERR_INVALID_PROGRAM_CATEGORY|PMERR_INVALID_PROGRAM_CATEGORY]]
+* [[OS2 API:PMI:error#PMERR_INVALID_WINDOW|PMERR_INVALID_WINDOW]]
+* [[OS2 API:PMI:error#PMERR_STARTED_IN_BACKGROUND|PMERR_STARTED_IN_BACKGROUND]]
 === Module ===
@@ Line 52: / Line 56: @@
   [[OS2 API:DataType:ULONG|ULONG]]       flags;
   [[OS2 API:DataType:HAPP|HAPP]]        invokedHndl;
+ ...
+ // populate PROGDETAILS structure...
   ...
   invokedHndl = WinStartApp(notifyHndl, progDetails, progParams, reserved, flags);
@@ Line 57: / Line 63: @@
 === Related Functions ===
+[[OS2 API:WinQueryTaskSizePos|WinQueryTaskSizePos]]
+[[OS2 API:WinSetWindowPos|WinSetWindowPos]]
 [[OS2 API:WinTerminateApp|WinTerminateApp]]