Condividi tramite


Funzione RmGetList (restartmanager.h)

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