DosSMStart: Difference between revisions

Revision as of 13:26, 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

0, start in foreground

1, start in background

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: @@
-{{Legacy
+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.
-|RepFunc=
-|Remarks=This page list the older version of the function for reference.
-}}
-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
-    =0, start in foreground
+::0, start in foreground
-    =1, start in background
+::1, start in background
+;type
-; type
+::0, normal session
-    =0, normal session
+::1, vio session
-    =1, vio session
+::2, windowed session
-    =2, windowed session
+::3, VDM session
-    =3, VDM session
+;null1: must be null
+;null2: must be null
-; null1 : must be null
+;args: program arguments
+;sessid: the newly generated session id is returned
-; null2 : must be null
+;unknown : ?
-; args : program arguments
-; sessid : the newly generated session id is returned
-; unknown : ?
 ==Return Code==
+ APIRET16 Pascal far
-==Remarks==
-==Example Code==
-<PRE>
-</PRE>
-==Related Functions==
-*
 [[Category:Dos]]