Funzione RmJoinSession (restartmanager.h)

Articolo
03/01/2024

Aggiunge un programma di installazione secondario a una sessione di Gestione riavvio esistente. Questa funzione deve essere chiamata con una chiave di sessione che può essere ottenuta solo dal programma di installazione primario che ha avviato la sessione. Per usare una delle funzioni di Gestione riavvio è necessaria una chiave di sessione valida. Dopo che un programma di installazione secondario partecipa a una sessione, può chiamare la funzione RmRegisterResources per registrare le risorse.

Sintassi

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

Parametri

[out] pSessionHandle

Puntatore all'handle di una sessione di Gestione riavvio esistente.

[in] strSessionKey

Stringa con terminazione Null contenente la chiave di sessione di una sessione esistente.

Valore restituito

Questo è l'errore più recente ricevuto. La funzione può restituire uno dei codici di errore di sistema definiti in Winerror.h.

Valore	Significato
ERROR_SUCCESS 0	La funzione è stata completata correttamente.
ERROR_SESSION_CREDENTIAL_CONFLICT 1219	La chiave di sessione non può essere convalidata.
ERROR_SEM_TIMEOUT 121	Una funzione di Gestione riavvio non è in grado di ottenere un mutex di scrittura del Registro di sistema nel tempo assegnato. È consigliabile riavviare il sistema perché è probabile che l'uso di Gestione riavvio abbia esito negativo.
ERROR_BAD_ARGUMENTS 22	Uno o più argomenti non sono corretti. Questo valore di errore viene restituito dalla funzione Restart Manager se un puntatore NULL o 0 viene passato in un parametro che richiede un valore diverso da null e diverso da zero.
ERROR_WRITE_FAULT 29	Un'operazione non è riuscita a leggere o scrivere nel Registro di sistema.
ERROR_MAX_SESSIONS_REACHED 353	È stato raggiunto il numero massimo di sessioni.
ERROR_OUTOFMEMORY 14	Impossibile completare un'operazione di Gestione riavvio perché non era disponibile memoria sufficiente.

Commenti

La funzione RmJoinSession aggiunge un programma di installazione secondario a una sessione di Gestione riavvio esistente. Si tratta in genere di un programma di installazione che non controlla l'interfaccia utente e può essere eseguito in-process o out-of-process del programma di installazione primario. Solo il programma di installazione primario può chiamare la funzione RmStartSession ed è in genere l'applicazione che controlla l'interfaccia utente o che controlla la sequenza di installazione di più patch in un aggiornamento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	restartmanager.h
Libreria	Rstrtmgr.lib
DLL	Rstrtmgr.dll

Vedi anche

RmEndSession

RmStartSession

Condividi tramite