RmJoinSession, fonction (restartmanager.h)

Article
03/01/2024

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

Partager via