DosSMStart: Difference between revisions

Latest revision as of 13:27, 3 September 2018

This allows the shell to start a new session. This can only be called by the shell that owns the session manager. I am not sure about the parameter 'type': this seems to be missing in some cases.

Syntax

APIRET16 Pascal far DOSSMSTART(short flag,short mode,short type, char far* null1,
                               char far* null2, char far* args, short* sessid, long unknown)

Parameters

flag

save parent session

0, yes

1, no

mode

session mode

0, start in foreground

1, start in background

type

session type

0, normal session

1, vio session

2, windowed session

3, VDM session

null1: must be null
null2: must be null
args: program arguments
sessid: the newly generated session id is returned
unknown: ?

Return Code

APIRET16 Pascal far

@@ Line 1: / Line 1: @@
-[[image:legacy.png]]
+This allows the shell to start a new session. This can only be called by the shell that owns the session manager. I am not sure about the parameter 'type': this seems to be missing in some cases.
-==Description==
-This allows the shell to start a new session. This can only be called by the shell that owns the session manager. I am not sure about the parameter 'type': this seems to be missing in some cases.
 ==Syntax==
-<PRE>
+ APIRET16 Pascal far DOSSMSTART(short flag,short mode,short type, char far* null1,
-APIRET16 Pascal far DOSSMSTART(short flag,short mode,short type, char far* null1,
+                                char far* null2, char far* args, short* sessid, long unknown)
-                               char far* null2, char far* args, short* sessid, long unknown)
-</PRE>
 ==Parameters==
-; flag : save parent session
+;flag: save parent session
-    =0, yes
+::0, yes
-    =1, no
+::1, no
+;mode: session mode
-; mode
+::0, start in foreground
-    =0, start in foreground
+::1, start in background
-    =1, start in background
+;type: session type
+::0, normal session
-; type
+::1, vio session
-    =0, normal session
+::2, windowed session
-    =1, vio session
+::3, VDM session
-    =2, windowed session
+;null1: must be null
-    =3, VDM session
+;null2: must be null
+;args: program arguments
-; null1 : must be null
+;sessid: the newly generated session id is returned
+;unknown : ?
-; null2 : must be null
-; args : program arguments
-; sessid : the newly generated session id is returned
-; unknown : ?
 ==Return Code==
+ APIRET16 Pascal far
-==Remarks==
+[[Category:Dos]]
-==Example Code==
-<PRE>
-</PRE>
-==Related Functions==
-*
-[[Category:The OS/2 API Project]]