DosSelectSession
Bindings: C, MASM
This call allows a parent session to switch one of its child sessions to
the foreground.
DosSelectSession (SessID, Reserved)
SessID (USHORT) - input
ID of the session to be switched to the foreground. The values are
their meanings are:
Value Definition
0 Switch the caller (the parent session) to the foreground.
<> 0 Switch the child session to the foreground. The nonzero
value specified for SessID must have been returned by a
previous DosStartSession request.
Reserved (ULONG) - input
A DWord of 0.
rc (USHORT) - return
Return code descriptions are:
0 NO_ERROR
369 ERROR_SMG_INVALID_SESSION_ID
418 ERROR_SMG_INVALID_CALL
451 ERROR_SMG_SESSION_NOT_FOREGRND
452 ERROR_SMG_SESSION_NOT_PARENT
459 ERROR_SMG_BAD_RESERVE
Remarks
DosSelectSession can be issued by a parent session to select only itself
or a child session. It cannot be used to select a grandchild session.
The child session must have been started by the caller with a request to
DosStartSession, specifying "Related = 1." Sessions started as
independent sessions cannot be selected with this call.
When DosSelectSession is issued, the session is brought to the foreground
only if the parent session or one of its descendant sessions is executing
in the foreground. Otherwise, ERROR_SMG_SESSION_NOT_FOREGRND is returned.
Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs