Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSSESMGR
 
USHORT DosSelectSession(idSession, ulReserved)
USHORT idSession;    /* session identifier */
ULONG ulReserved;    /* must be zero       */
 
The DosSelectSession function switches the specified child session to the
foreground. Only the parent session can call DosSelectSession to switch a
session. The parent session, or one of its descendant sessions, must be
currently executing in the foreground when DosSelectSession is called. If
the parent session is not in foreground, it can use DosSelectSession to
switch itself to the foreground.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
idSession   Specifies the identifier of the session to be switched to the
            foreground. This identifier must have been created previously by
            using the DosStartSession function. If idSession is 0x0000, the
            function switches the parent session to the foreground.
 
ulReserved  Specifies a reserved value; must be zero.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value.
 
Comments
 
The DosSelectSession function can only select a child session that was
created by using the DosStartSession function with the Related field of the
STARTDATA structure set to TRUE. In other words, this function cannot select
sessions started as independent sessions.
 
See Also
 
DosSetSession, DosStartSession, DosStopSession, STARTDATA
 
                                      ♦