Funzione RmGetList (restartmanager.h)

Articolo
11/18/2024

Ottiene un elenco di tutte le applicazioni e i servizi che attualmente usano 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 che usano 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

Si tratta dell'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 Di gestione riavvio se un NULL puntatore o 0 viene passato in un parametro che richiede unnull e un valore 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.
ERROR_ACCESS_DENIED 5	Un percorso registrato nella sessione di Gestione riavvio è una directory.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	restartmanager.h
libreria	Rstrtmgr.lib
dll	Rstrtmgr.dll

Vedere anche

RmCancelCurrentTask

Condividi tramite