[ Home | Alpha index | Topic index | Tutorials | Download | Feedback ]

The OS/2 API Project

DosSelectSession

[ Syntax | Params | Returns | Include | Usage | Structs | Gotchas | Code | Also ]

Syntax

 rc = DosSelectSession( ulIDSession );

Parameters
ULONG ulIDSession (input)
The ID of the session to be switched to the foreground.

Returns

 
APIRET  rc
0       NO_ERROR
224     ERROR_SMG_NO_TARGET_WINDOW
369     ERROR_SMG_INVALID_SESSION_ID
418     ERROR_SMG_INVALID_CALL
459     ERROR_SMG_BAD_RESERVE
460     ERROR_SMG_PROCESS_NOT_PARENT
463     ERROR_SMG_RETRY_SUB_ALLOC

Include Info

 #define INCL_DOSSESMGR
#include <os2.h>

Usage Explanation

 DosSelectSession lets a parent session switch one of its child sessions or itself to the foreground, no grandchild session or any other descendant beyond a child session can be selected. The child process will not be brought to the foreground unless the parent session or one of its descendant sessions is currently executing in the foreground. For windowed applications is the application that owns the window focus the foreground session. It is only possible to issue DosSelectSession on sessions started by the current session with DosStartSession, with Related set to SSF_RELATED_CHILD (=1).

Relevant Structures

Gotchas

Sample Code

 #define INCL_DOSSESMGR #include <os2.h> ULONG ulIDSession; /* Start a child session with DosStartSession */ /* psd->Related=SSF_RELATED_CHILD; */ /* DosStartSession(psd,&ulIDSession,..); */ if(DosSelectSession(ulIDSession)) /* Switch child session to foreground */ { /* Problems */ } else { /* The child session is now in the foreground */ }

See Also

 DosStartSession, DosStopSession, DosSetSession

Author

Oscar Gustafsson - oscar@lysator.liu.se

Additions

Last modified September 21/1996
Please send all errors, comments, and suggestions to: timur@vnet.ibm.com

The OS/2 API Project

DosSelectSession