DosStopSession |
DOS : Arrête la session |
|---|---|
| SESMGR.DLL | os2.h |
Syntaxe
| APIRET DosStopSession( ULONG ulScope, ULONG ulIDSession ); |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| ulScope | Ce paramètre permet d'indiquer si la session enfant ou toutes les sessions enfant doivent terminé : | ||
| Constante | Valeur | Description | |
| STOP_SESSION_SPECIFIED | 0 | Cette valeur permet d'indiquer qu'elle est la session enfant à arrêter à l'aide du paramètre ulIDSession. | |
| STOP_SESSION_ALL | 1 | Cette valeur permet d'indiquer que toutes les sessions enfants sont terminés. Le paramètre ulIDSession est ignoré. | |
| ulIDSession | Ce paramètre permet d'indiquer la session enfant a arrêter. Le paramètre ulScope doit être fixé sur STOP_SESSION_SPECIFIED. | ||
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. |
| 458 | ERROR_SMG_INVALID_STOP_OPTION | Cette valeur permet d'indiquer un option d'arrêt invalide dans le 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 d'arrêter une ou plusieurs sessions.
Exemple
Voici un simple exemple montrant comme appeler cette API avec WatCom C++ for OS/2 :
- #define INCL_DOSERRORS
- #define INCL_DOSSESMGR
- #include "os2.h"
- #include "stdio.h"
-
- void main(void) {
- ULONG ulIDSession;
- switch(DosStopSession(STOP_SESSION_SPECIFIED, ulIDSession)) {
- case NO_ERROR: printf("Tout va bien !");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 : Appel invalide au gestionnaire de session.");break;
- case ERROR_SMG_INVALID_STOP_OPTION: printf("Erreur : Un option d'arrêt d'arret invalide dans le gestionnaire de session.");break;
- case ERROR_SMG_BAD_RESERVE: printf("Erreur : Une mauvaise réservation dans le 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 - DosStartSession
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010