Funzione RmGetList (restartmanager.h)

Articolo
03/15/2023

Ottiene un elenco di tutte le applicazioni e i servizi che usano attualmente risorse registrate con la sessione di Gestione riavvio.

Sintassi

DWORD RmGetList(
  [in]                DWORD              dwSessionHandle,
  [out]               UINT               *pnProcInfoNeeded,
  [in, out]           UINT               *pnProcInfo,
  [in, out, optional] RM_PROCESS_INFO [] rgAffectedApps,
  [out]               LPDWORD            lpdwRebootReasons
);

Parametri

[in] dwSessionHandle

Handle per una sessione di Gestione riavvio esistente.

[out] pnProcInfoNeeded

Puntatore a una dimensione di matrice necessaria per ricevere RM_PROCESS_INFO strutture necessarie per restituire informazioni per tutte le applicazioni e i servizi interessati.

[in, out] pnProcInfo

Puntatore al numero totale di strutture RM_PROCESS_INFO in una matrice e al numero di strutture riempite.

[in, out, optional] rgAffectedApps

Matrice di strutture RM_PROCESS_INFO che elencano le applicazioni e i servizi usando le risorse registrate nella sessione.

[out] lpdwRebootReasons

Puntatore alla posizione che riceve un valore dell'enumerazione RM_REBOOT_REASON che descrive il motivo per cui è necessario un riavvio del sistema.

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_MORE_DATA 234	Questo valore di errore viene restituito dalla funzione RmGetList se il buffer rgAffectedApps è troppo piccolo per contenere tutte le informazioni sull'applicazione nell'elenco.
ERROR_CANCELLED 1223	L'operazione corrente viene annullata dall'utente.
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_WRITE_FAULT 29	Un'operazione non è riuscita a leggere o scrivere nel Registro di sistema.
ERROR_OUTOFMEMORY 14	Impossibile completare un'operazione di Gestione riavvio perché non era disponibile memoria sufficiente.
ERROR_INVALID_HANDLE 6	Non esiste alcuna sessione di Gestione riavvio per l'handle fornito.

Requisiti


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

RmCancelCurrentTask

Condividi tramite