Partager via

RmStartSession, fonction (restartmanager.h)

Démarre une nouvelle session Restart Manager. Au maximum 64 sessions du Gestionnaire de redémarrage par session utilisateur peuvent être ouvertes sur le système en même temps. Lorsque cette fonction démarre une session, elle retourne un handle de session et une clé de session qui peuvent être utilisés dans les appels suivants à l’API Restart Manager.

Syntaxe

DWORD RmStartSession(
  [out] DWORD    *pSessionHandle,
        DWORD    dwSessionFlags,
  [out] WCHAR [] strSessionKey
);

Paramètres

[out] pSessionHandle

Pointeur vers le handle d’une session Restart Manager. Le handle de session peut être transmis dans les appels suivants à l’API Restart Manager.

dwSessionFlags

Réservé. Ce paramètre doit être 0.

[out] strSessionKey

Chaîne terminée par null qui contient la clé de session à la nouvelle session. La chaîne de taille CCH_RM_SESSION_KEY + 1 doit être allouée avant d’appeler la fonction RmStartSession .

Valeur retournée

Il s’agit de l’erreur la plus récente reçue. La fonction peut retourner l’un des codes d’erreur système définis dans Winerror.h.

Valeur Sens
ERROR_SUCCESS
0
 La fonction s’est terminée correctement.
ERROR_SEM_TIMEOUT
121
 Une fonction Restart Manager n’a pas pu obtenir un mutex d’écriture de Registre dans le temps imparti. Un redémarrage du système est recommandé, car une utilisation supplémentaire du Gestionnaire de redémarrage est susceptible d’échouer.
ERROR_BAD_ARGUMENTS
160
 Un ou plusieurs arguments ne sont pas corrects. Cette valeur d’erreur est retournée par la fonction Restart Manager si un pointeur NULL ou 0 est passé dans un paramètre qui nécessite une valeur non null et non nulle.
ERROR_MAX_SESSIONS_REACHED
353
 Le nombre maximal de sessions a été atteint.
ERROR_WRITE_FAULT
29
 Le système ne peut pas écrire sur l’appareil spécifié.
ERROR_OUTOFMEMORY
14
 Une opération restart Manager n’a pas pu se terminer, car la mémoire n’a pas été suffisante.

Remarques

La fonction RmStartSession retourne une erreur si une session avec la même clé de session existe déjà.

La fonction RmStartSession doit être appelée par le programme d’installation principal qui contrôle l’interface utilisateur ou qui contrôle la séquence d’installation de plusieurs correctifs dans une mise à jour.

Un programme d’installation secondaire peut rejoindre une session Restart Manager existante en appelant la fonction RmJoinSession avec le handle de session et la clé de session retournés par l’appel de fonction RmStartSession du programme d’installation principal.

Spécifications

Besoin Valeur
Client minimum requis Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
plateforme cible Fenêtres
En-tête restartmanager.h
Bibliothèque Rstrtmgr.lib
DLL Rstrtmgr.dll

Voir aussi

RmEndSession

RmJoinSession

  • Last updated on