Funzione RmStartSession (restartmanager.h)

Articolo
03/01/2024

Avvia una nuova sessione di Restart Manager. Un massimo di 64 sessioni di Gestione riavvio per sessione utente può essere aperto contemporaneamente nel sistema. Quando questa funzione avvia una sessione, restituisce un handle di sessione e una chiave di sessione che possono essere usati nelle chiamate successive all'API di Gestione riavvio.

Sintassi

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

Parametri

[out] pSessionHandle

Puntatore all'handle di una sessione di Restart Manager. L'handle di sessione può essere passato nelle chiamate successive all'API di Gestione riavvio.

dwSessionFlags

Riservato. Questo parametro deve essere 0.

[out] strSessionKey

Stringa con terminazione Null che contiene la chiave di sessione per la nuova sessione. La stringa deve essere allocata prima di chiamare la funzione RmStartSession .

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_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 160	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_MAX_SESSIONS_REACHED 353	È stato raggiunto il numero massimo di sessioni.
ERROR_WRITE_FAULT 29	Il sistema non può scrivere nel dispositivo specificato.
ERROR_OUTOFMEMORY 14	Impossibile completare un'operazione di Gestione riavvio perché non era disponibile memoria sufficiente.

Commenti

La funzione RmStartSession restituisce un errore se esiste già una sessione con la stessa chiave di sessione.

La funzione RmStartSession deve essere chiamata dal programma di installazione primario che controlla l'interfaccia utente o che controlla la sequenza di installazione di più patch in un aggiornamento.

Un programma di installazione secondario può partecipare a una sessione di Gestione riavvio esistente chiamando la funzione RmJoinSession con l'handle di sessione e la chiave di sessione restituiti dalla chiamata di funzione RmStartSession del programma di installazione primario.

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

RmJoinSession

Condividi tramite