DosSMSwitch: Difference between revisions

Revision as of 20:37, 26 February 2017

Request the session manager to switch to another foreground session. If PM is present, also internally call WinSetExtIdFocus. This can only be called by the shell that owns the Session Manager.

Syntax

DosSMSwitch (cmd, sessid, unknown)

Parameters

cmd (short): 0 do a normal session switch; 1 switch to the next queued session; 2 don't save state of the current foreground session; 3 don't restore state of current foreground session; 4 ?; 5 similar to 4 ?
sessid (short): requested session id
unknown (ULONG): must be 0

Return Code

APIRET16 Pascal far

@@ Line 1: / Line 1: @@
-[[image:legacy.png]]
-==Description==
 Request the session manager to switch to another foreground session. If PM is present, also internally call WinSetExtIdFocus. This can only be called by the shell that owns the Session Manager.
+==Syntax==
+ DosSMSwitch (cmd, sessid, unknown)
-==Syntax==
-<PRE>
-APIRET16 Pascal far DOSSMSWITCH(short cmd,short sessid,ULONG unknown)
-</PRE>
 ==Parameters==
-; cmd :
+;cmd (short):
-    =0 do a normal session switch
+:0 do a normal session switch
-    =1 switch to the next queued session
+:1 switch to the next queued session
-    =2 don't save state of the current fg session
+:2 don't save state of the current foreground session
-    =3 don't restore state of current fg session
+:3 don't restore state of current foreground session
-    =4 ???
+:4 ?
-    =5 similar to 4 ???
+:5 similar to 4 ?
+;sessid (short): requested session id
-; sessid : requested session id
+;unknown (ULONG): must be 0
-; unknown : must be 0
 ==Return Code==
+ APIRET16 Pascal far
-==Remarks==
+[[Category:Dos]]
-==Example Code==
-<PRE>
-</PRE>
-==Related Functions==
-*
-[[Category:The OS/2 API Project]]