Section courante

A propos

Section administrative du site

DosSelectSession

DOS : Sélectionne une session
SESMGR.DLL os2.h

Syntaxe

APIRET DosSelectSession( ULONG ulIDSession );

Paramètres

Nom Description
ulIDSession Ce paramètre permet d'indiquer l'identificateur de session à échanger avec le premier plan.

Retour

Valeur Constante Description
0 NO_ERROR Cette valeur permet d'indiquer que l'opération s'est correctement effectué
224 ERROR_SMG_NO_TARGET_WINDOW Cette valeur permet d'indiquer qu'il n'y a pas de gestionnaire de session pour la fenêtre de destination.
369 ERROR_SMG_INVALID_SESSION_ID Cette valeur permet d'indiquer que l'identificateur de session est invalide pour le gestionnaire de session.
418 ERROR_SMG_INVALID_CALL Cette valeur permet d'indiquer un appel invalide au gestionnaire de session.
459 ERROR_SMG_BAD_RESERVE Cette valeur permet d'indiquer une mauvaise réservé dans le gestionnaire de session.
460 ERROR_SMG_PROCESS_NOT_PARENT Cette valeur permet d'indiquer que le processus n'a pas de parent dans le gestionnaire de session.
463 ERROR_SMG_RETRY_SUB_ALLOC Cette valeur permet d'indiquer une tentative réallocation dans le gestionnaire de session n'a pas réussis.

Description

Cette fonction permet de faire basculer une session parent de sa session enfant ou en avant plan, aucune session de petit-enfant ou autre descendant au delà de la session enfant ne peut être sélectionné.

Exemple

Voici un simple exemple montrant comme appeler cette API avec WatCom C++ for OS/2 :

  1. #define INCL_DOSERRORS
  2. #define INCL_DOSSESMGR
  3. #include "os2.h"
  4. #include "stdio.h"
  5.  
  6. void main(void) {
  7.     ULONG ulIDSession;
  8.     switch(DosSelectSession(ulIDSession)) {
  9.         case NO_ERROR: printf("Tout va bien !");break;
  10.         case ERROR_SMG_NO_TARGET_WINDOW: printf("Erreur : Il n'y a pas de gestionnaire de session pour la fenêtre de destination.");break;
  11.         case ERROR_SMG_INVALID_SESSION_ID: printf("Erreur : Identificateur de session est invalide pour le gestionnaire de session.");break;
  12.         case ERROR_SMG_INVALID_CALL: printf("Erreur : Un appel invalide au gestionnaire de session.");break;
  13.         case ERROR_SMG_BAD_RESERVE: printf("Erreur : Une mauvaise réservé dans le gestionnaire de session.");break;
  14.         case ERROR_SMG_PROCESS_NOT_PARENT: printf("Erreur : Le processus n'a pas de parent dans le gestionnaire de session.");break;
  15.         case ERROR_SMG_RETRY_SUB_ALLOC: printf("Erreur : Une tentative réallocation dans le gestionnaire de session n'a pas réussis.");break;
  16.     }
  17. }

Voir également

Langage de programmation - C pour OS/2 - DosStartSession
Langage de programmation - C pour OS/2 - DosStopSession
Langage de programmation - C pour OS/2 - DosSetSession
Système d'exploitation - OS/2 - Introduction

Dernière mise à jour : Lundi, le 19 juillet 2010