RmGetList-Funktion (restartmanager.h)
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 |
---|---|
|
Die Funktion wurde erfolgreich abgeschlossen. |
|
Dieser Fehlerwert wird von der RmGetList-Funktion zurückgegeben, wenn der rgAffectedApps-Puffer zu klein ist, um alle Anwendungsinformationen in der Liste zu speichern. |
|
Der aktuelle Vorgang wird vom Benutzer abgebrochen. |
|
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. |
|
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. |
|
Ein Vorgang konnte weder lesen noch in die Registrierung schreiben. |
|
Ein Neustart-Manager-Vorgang konnte nicht abgeschlossen werden, weil nicht genügend Arbeitsspeicher verfügbar war. |
|
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 |