DosStartSession |
DOS : Démarre la session |
|---|---|
| SESMGR.DLL | os2.h |
Syntaxe
| APIRET DosStartSession( PSTARTDATA psd, ULONG pulIDSession, PPID ppid ); |
Paramètres
| Nom | Description | ||||
|---|---|---|---|---|---|
| psd | Ce paramètre permet d'indiquer permet d'indiquer la structure de la «STARTDATA» : | ||||
| Champs | Type de données | Description | |||
| Length | USHORT | Ce champ permet d'indiquer la longueur de la structure de données (peut être 0x0018, 0x001E, 0x0020, 0x0032 ou 0x003C). | |||
| Related | USHORT | Ce champ permet d'indiquer la relation du nouveau processus à appeler : | |||
| Constante | Valeur | Description | |||
| SSF_RELATED_INDEPENDENT | 0 | Cette valeur permet d'indiquer qu'il faut démarrer une nouvelle session totalement indépendante de la session actuel. | |||
| SSF_RELATED_CHILD | 1 | Cette valeur permet d'indiquer qu'il faut démarrer une nouvelle session enfant de la session actuel. | |||
| FgBg | USHORT | Ce champ permet d'indiquer la priorité de la session : | |||
| Constante | Valeur | Description | |||
| SSF_FGBG_FORE | 0 | Cette valeur permet d'indiquer que la nouvelle session est démarré au premier plan. | |||
| SSF_FGBG_BACK | 1 | Cette valeur permet d'indiquer que la nouvelle session est démarré en arrière-plan. | |||
| TraceOpt | USHORT | Ce champ permet d'indiquer les options de tracage : | |||
| Constante | Valeur | Description | |||
| SSF_TRACEOPT_NONE | 0 | Cette valeur permet d'indiquer qu'il n'y a aucun traçage. | |||
| SSF_TRACEOPT_TRACE | 1 | Cette valeur permet d'indiquer qu'il y a un traçage pour cette session mais sans avertissement pour ses descendants. | |||
| SSF_TRACEOPT_TRACEALL | 2 | Cette valeur permet d'indiquer qu'il y a un traçage pour cette session et ses descendants. | |||
| PgmTitle | PSZ | Ce champ permet d'indiquer le titre en format ASCIZ du programme ou sur l'adresse NULL. Si l'adresse est NULL, le nom du programme est utilisé comme titre. | |||
| PgmName | PSZ | Ce champ permet d'indiquer le nom en format ASCIZ du programme à charger ou sur l'adresse NULL. | |||
| PgmInputs | PBYTE | Ce champ permet d'indiquer les arguments en format ASCIZ du programme. | |||
| TermQ | PBYTE | Ce champ permet d'indiquer un pointeur sur une chaîne de caractères du nom de la file d'attente, d'un avertissement quand le programme se termine. Les données envoyés à la queue ont la forme : USHORT SessionID, USHORT ReturnCode. | |||
| Environment | PBYTE | Ce champ permet d'indiquer sur les variables d'environnement ou sur l'adresse NULL si vous n'utilisez pas de nouvel environnement spécifique. | |||
| InheritOpt | USHORT | Ce champ permet d'indiquer la nouvelle session hérite des fichiers Handle ouvert et de l'environnement du processus appelant. Voici les valeurs possibles : | |||
| Constante | Valeur | Description | |||
| SSF_INHERTOPT_SHELL | 0 | Cette valeur permet d'indiquer que la nouvelle session n'hérite pas du parent mais de l'interpréteur de commande. | |||
| SSF_INHERTOPT_PARENT | 1 | Cette valeur permet d'indiquer que la nouvelle session hérite du processus parent. | |||
| SessionType | USHORT | Ce champ permet d'indiquer le type de session à lancer. Voici les valeurs possibles : | |||
| Constante | Valeur | Description | |||
| SSF_TYPE_DEFAULT | 0 | Cette valeur permet d'indiquer un Gestionnaire de session d'OS/2 va déterminer le type de session devant être lancée (par défaut). | |||
| SSF_TYPE_FULLSCREEN | 1 | Cette valeur permet d'indiquer une session OS/2 pleine écran. | |||
| SSF_TYPE_WINDOWABLEVIO | 2 | Cette valeur permet d'indiquer une session OS/2 en fenêtre. | |||
| SSF_TYPE_PM | 3 | Cette valeur permet d'indiquer une session du Gestionnaire de présentation d'OS/2 (PM). | |||
| SSF_TYPE_VDM | 4 | Cette valeur permet d'indiquer une session DOS pleine écran. | |||
| SSF_TYPE_WINDOWEDVDM | 7 | Cette valeur permet d'indiquer une session DOS en fenêtre. | |||
| PROG_31_STDSEAMLESSVDM | 15 | Cette valeur permet d'indiquer une session Windows 3.1 standard dans sa fenêtre. | |||
| PROG_31_STDSEAMLESSCOMMON | 16 | Cette valeur permet d'indiquer une session Windows 3.1 standard dans une fenêtre communes. | |||
| PROG_31_ENHSEAMLESSVDM | 17 | Cette valeur permet d'indiquer une session Windows 3.1 étendu dans sa fenêtre. | |||
| PROG_31_ENHSEAMLESSCOMMON | 18 | Cette valeur permet d'indiquer une session Windows 3.1 étendu dans une fenêtre communes. | |||
| PROG_31_ENH | 19 | Cette valeur permet d'indiquer une session Windows 3.1 étendu pleine écran. | |||
| PROG_31_STD | 20 | Cette valeur permet d'indiquer une session Windows 3.1 standard pleine écran. | |||
| IconFile | PSZ | Ce champ permet d'indiquer le nom de l'icône à utiliser en format ASCIZ pour cette session ou l'adresse NULL s'il n'y en pas de spécifique. Lorsque la valeur est NULL, il utilise l'icône par défaut. | |||
| PgmHandle | PSZ | Ce champ permet d'indiquer le Handle du programme retourné par WinAddProgram ou WinQueryProgramHandle. Ce champ vaut 0 si cette fonction n'est pas utilisé. | |||
| PgmControl | USHORT | Ce champ permet de spécifier l'attribut d'initialisation pour une session de fenêtre OS/2 ou une fenêtre DOS. Voici les valeurs possibles : | |||
| Constante | Valeur | Description | |||
| SSF_CONTROL_VISIBLE | 0 | Cette valeur permet d'indiquer que la fenêtre est visible. | |||
| SSF_CONTROL_INVISIBLE | 1 | Cette valeur permet d'indiquer que la fenêtre est invisible. | |||
| SSF_CONTROL_MAXIMIZE | 2 | Cette valeur permet d'indiquer que la fenêtre est maximiser. | |||
| SSF_CONTROL_MINIMIZE | 4 | Cette valeur permet d'indiquer que la fenêtre est minimiser. | |||
| SSF_CONTROL_NOAUTOCLOSE | 8 | Cette valeur permet d'indiquer que la fenêtre n'est pas fermé après que le programme est terminé. | |||
| SSF_CONTROL_SETPOS | 32768 | Cette valeur permet d'indiquer l'emplacement de la fenêtre et sa taille. | |||
| InitXPos | USHORT | Ce champ permet d'indiquer la position X d'une fenêtre de session. La constante SSF_CONTROL_SETPOS doit être fixé dans le champ PgmControl. | |||
| InitYPos | USHORT | Ce champ permet d'indiquer la position Y d'une fenêtre de session. La constante SSF_CONTROL_SETPOS doit être fixé dans le champ PgmControl. | |||
| InitXSize | USHORT | Ce champ permet d'indiquer la largeur (horizontal) d'une fenêtre de session. La constante SSF_CONTROL_SETPOS doit être fixé dans le champ PgmControl. | |||
| InitYSize | USHORT | Ce champ permet d'indiquer la hauteur (vertical) d'une fenêtre de session. La constante SSF_CONTROL_SETPOS doit être fixé dans le champ PgmControl. | |||
| Reserved | USHORT | Ce champ est réservé et vaut toujours 0. | |||
| ObjectBuffer | PSZ | Ce champ contient un pointeur vers un tampon dans lequel le nom d'objet de traitement d'échec de cette fonction se produit. | |||
| ObjectBuffLen | ULONG | Ce champ permet d'indiquer la taille du tampon du champ ObjectBuffer. | |||
| pulIDSession | Ce paramètre permet d'indiquer un pointeur double mot contenant l'identificateur de session de la session enfant démarré. | ||||
| ppid | Ce paramètre permet d'indiquer un pointeur double mot contenant l'identificateur de processus de la session enfant démarré. | ||||
Retour
| Valeur | Constante | Description |
|---|---|---|
| 0 | NO_ERROR | Cette valeur permet d'indiquer que l'opération s'est correctement effectué |
| 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. |
| 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 d'utiliser le début d'une autre session, laquelle peut être de n'importe quel type, et d'opposer les sessions démarré avec DosExecPgm et peu rendre indépendant ou en processus enfant.
Exemple
Voici un simple exemple montrant comme appeler cette API avec WatCom C++ for OS/2 :
- #define INCL_DOSERRORS
- #define INCL_DOSSESMGR
- #define INCL_DOSMEMMGR
- #include "os2.h"
- #include "stdio.h"
- #include "memory.h"
-
- void main(void) {
- STARTDATA sd;
- PID pid;
- ULONG ulSession;
- memset(&sd,0,sizeof(STARTDATA));
- sd.Length = sizeof(STARTDATA);
- sd.Related = SSF_RELATED_CHILD;
- sd.PgmName="C:\\OS2\\CMD.EXE";
- switch(DosStartSession(&sd, &ulSession, &pid)) {
- case NO_ERROR: printf("Identificateur de session : %d\n",(USHORT)ulSession);break;
- case ERROR_SMG_INVALID_SESSION_ID: printf("Erreur : Identificateur de session est invalide pour le gestionnaire de session.");break;
- case ERROR_SMG_INVALID_CALL: printf("Erreur : Un appel invalide au gestionnaire de session.");break;
- case ERROR_SMG_PROCESS_NOT_PARENT: printf("Erreur : Le processus n'a pas de parent dans le gestionnaire de session.");break;
- case ERROR_SMG_RETRY_SUB_ALLOC: printf("Erreur : Une tentative réallocation dans le gestionnaire de session n'a pas réussis.");break;
- }
- }
Voir également
Langage de programmation - C pour OS/2 - DosStopSession
Langage de programmation - C pour OS/2 - DosSetSession
Langage de programmation - C pour OS/2 - DosSelectSession
Langage de programmation - C pour OS/2 - DosExecPgm
Langage de programmation - Assembleur 80x86 - Interruption 21h, Fonction 64h: OS/2 API DOS32StartSession
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010