DosSelectSession

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:
• 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.

  ---

  [Back: DosSelectDisk]
  [Next: DosSemClear]