Partager via

RmJoinSession, fonction (restartmanager.h)

  • Article

Joint un programme d’installation secondaire à une session du Gestionnaire de redémarrage existante. Cette fonction doit être appelée avec une clé de session qui ne peut être obtenue qu’auprès du programme d’installation principal qui a démarré la session. Une clé de session valide est nécessaire pour utiliser l’une des fonctions du Gestionnaire de redémarrage. Une fois qu’un programme d’installation secondaire rejoint une session, il peut appeler la fonction RmRegisterResources pour inscrire des ressources.

Syntaxe

DWORD RmJoinSession(
  [out] DWORD          *pSessionHandle,
  [in]  const WCHAR [] strSessionKey
);

Paramètres

[out] pSessionHandle

Pointeur vers le handle d’une session de gestionnaire de redémarrage existante.

[in] strSessionKey

Chaîne terminée par null qui contient la clé de session d’une session existante.

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 Signification
ERROR_SUCCESS
0
 La fonction s’est terminée avec succès.
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 La clé de session ne peut pas être validée.
ERROR_SEM_TIMEOUT
121
 Une fonction Restart Manager n’a pas pu obtenir un mutex d’écriture dans le registre dans le délai imparti. Un redémarrage du système est recommandé, car l’utilisation ultérieure du Gestionnaire de redémarrage risque d’échouer.
ERROR_BAD_ARGUMENTS
22
 Un ou plusieurs arguments sont incorrects. 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 une valeur non nulle.
ERROR_WRITE_FAULT
29
 Une opération n’a pas pu lire ou écrire dans le Registre.
ERROR_MAX_SESSIONS_REACHED
353
 Le nombre maximal de connexions est atteint.
ERROR_OUTOFMEMORY
14
 Une opération de redémarrage du Gestionnaire n’a pas pu se terminer, car la mémoire disponible était insuffisante.

Remarques

La fonction RmJoinSession joint un programme d’installation secondaire à une session Restart Manager existante. Il s’agit généralement d’un programme d’installation qui ne contrôle pas l’interface utilisateur et peut exécuter in-process ou out-of-process du programme d’installation principal. Seul le programme d’installation principal peut appeler la fonction RmStartSession . Il s’agit généralement de l’application qui contrôle l’interface utilisateur ou qui contrôle la séquence d’installation de plusieurs correctifs dans une mise à jour.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête restartmanager.h
Bibliothèque Rstrtmgr.lib
DLL Rstrtmgr.dll

Voir aussi

RmEndSession

RmStartSession