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.