RmGetList-Funktion (restartmanager.h)

Artikel
11/18/2024

Ruft eine Liste aller Anwendungen und Dienste ab, die derzeit Ressourcen verwenden, die bei der Neustart-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 Neustart-Manager-Sitzung.

[out] pnProcInfoNeeded

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

[in, out] pnProcInfo

Ein Zeiger auf die Gesamtanzahl 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 position, der einen Wert der RM_REBOOT_REASON-Aufzählung empfängt, die den Grund für einen Systemneustart beschreibt.

Rückgabewert

Dies ist der letzte empfangene Fehler. Die Funktion kann eine 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 Registrierungsschreib-Mutex abrufen. Ein Systemneustart wird empfohlen, da die weitere Verwendung des Neustart-Managers wahrscheinlich fehlschlägt.
ERROR_BAD_ARGUMENTS 160	Mindestens ein Argument ist nicht korrekt. Dieser Fehlerwert wird von der Neustart-Manager-Funktion zurückgegeben, wenn ein NULL- Zeiger oder 0 in einem Parameter übergeben wird, der eine nicht-NULL- und einen Wert ungleich Null erfordert.
ERROR_WRITE_FAULT 29	Ein Vorgang konnte die Registrierung nicht lesen oder schreiben.
ERROR_OUTOFMEMORY 14	Ein Neustart-Manager-Vorgang konnte nicht abgeschlossen werden, da nicht genügend Arbeitsspeicher verfügbar war.
ERROR_INVALID_HANDLE 6	Für das bereitgestellte Handle ist keine Neustart-Manager-Sitzung vorhanden.
ERROR_ACCESS_DENIED 5	Ein Pfad, der in der Neustart-Manager-Sitzung registriert ist, ist ein Verzeichnis.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	restartmanager.h
Library	Rstrtmgr.lib
DLL-	Rstrtmgr.dll

Siehe auch

RmCancelCurrentTask

Freigeben über