RmGetList-Funktion (restartmanager.h)

Artikel
08/25/2023

Ruft eine Liste aller Anwendungen und Dienste ab, die derzeit Ressourcen verwenden, die bei der Restart Manager-Sitzung registriert wurden.

Syntax

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

Parameter

[in] dwSessionHandle

Ein Handle für eine vorhandene Restart Manager-Sitzung.

[out] pnProcInfoNeeded

Ein Zeiger auf eine Arraygröße, die erforderlich ist, um RM_PROCESS_INFO Strukturen zu empfangen, die erforderlich sind, um Informationen für alle betroffenen Anwendungen und Dienste zurückzugeben.

[in, out] pnProcInfo

Ein Zeiger auf die Gesamtzahl der RM_PROCESS_INFO Strukturen in einem Array und die Anzahl der gefüllten Strukturen.

[in, out, optional] rgAffectedApps

Ein Array von RM_PROCESS_INFO Strukturen, die die Anwendungen und Dienste mithilfe von Ressourcen auflisten, die bei der Sitzung registriert wurden.

[out] lpdwRebootReasons

Zeiger auf den Speicherort, der einen Wert der RM_REBOOT_REASON-Enumeration empfängt, der den Grund beschreibt, warum ein Systemneustart erforderlich ist.

Rückgabewert

Dies ist der letzte empfangene Fehler. Die Funktion kann einen der Systemfehlercodes zurückgeben, die in Winerror.h definiert sind.

Wert	Bedeutung
ERROR_SUCCESS 0	Die Funktion wurde erfolgreich abgeschlossen.
ERROR_MORE_DATA 234	Dieser Fehlerwert wird von der RmGetList-Funktion zurückgegeben, wenn der rgAffectedApps-Puffer zu klein ist, um alle Anwendungsinformationen in der Liste zu speichern.
ERROR_CANCELLED 1223	Der aktuelle Vorgang wird vom Benutzer abgebrochen.
ERROR_SEM_TIMEOUT 121	Eine Neustart-Manager-Funktion konnte in der zugewiesenen Zeit keinen Registrierungs-Schreibmutex abrufen. Ein Systemneustart wird empfohlen, da die weitere Verwendung des Neustart-Managers wahrscheinlich fehlschlägt.
ERROR_BAD_ARGUMENTS 160	Mindestens ein Argument ist falsch. Dieser Fehlerwert wird von der Funktion Restart Manager zurückgegeben, wenn ein NULL-Zeiger oder 0 in einem Parameter übergeben wird, der einen Wert ungleich NULL und ungleich Null erfordert.
ERROR_WRITE_FAULT 29	Ein Vorgang konnte weder lesen noch in die Registrierung schreiben.
ERROR_OUTOFMEMORY 14	Ein Neustart-Manager-Vorgang konnte nicht abgeschlossen werden, weil nicht genügend Arbeitsspeicher verfügbar war.
ERROR_INVALID_HANDLE 6	Für das bereitgestellte Handle ist keine Restart Manager-Sitzung vorhanden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	restartmanager.h
Bibliothek	Rstrtmgr.lib
DLL	Rstrtmgr.dll

Weitere Informationen

RmCancelCurrentTask

Share via