RmRegisterResources-Funktion (restartmanager.h)

Artikel
08/25/2023

Registriert Ressourcen für eine Restart Manager-Sitzung. Der Neustart-Manager verwendet die Liste der bei der Sitzung registrierten Ressourcen, um zu bestimmen, welche Anwendungen und Dienste heruntergefahren und neu gestartet werden müssen. Ressourcen können durch Dateinamen, Kurznamen des Diensts oder RM_UNIQUE_PROCESS Strukturen identifiziert werden, die ausgeführte Anwendungen beschreiben. Die RmRegisterResources-Funktion kann von einem primären oder sekundären Installationsprogramm verwendet werden.

Syntax

DWORD RmRegisterResources(
  [in]           DWORD                dwSessionHandle,
  [in]           UINT                 nFiles,
  [in, optional] LPCWSTR []           rgsFileNames,
  [in]           UINT                 nApplications,
  [in, optional] RM_UNIQUE_PROCESS [] rgApplications,
  [in]           UINT                 nServices,
  [in, optional] LPCWSTR []           rgsServiceNames
);

Parameter

[in] dwSessionHandle

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

[in] nFiles

Die Anzahl der registrierten Dateien.

[in, optional] rgsFileNames

Ein Array von NULL-beendeten Zeichenfolgen mit vollständigen Dateinamenpfaden. Dieser Parameter kann NULL sein, wenn nFiles 0 ist.

[in] nApplications

Die Anzahl der registrierten Prozesse.

[in, optional] rgApplications

Ein Array von RM_UNIQUE_PROCESS Strukturen. Dieser Parameter kann NULL sein, wenn nApplications 0 ist.

[in] nServices

Die Anzahl der zu registrierenden Dienste.

[in, optional] rgsServiceNames

Ein Array von NULL-beendeten Zeichenfolgen von Kurznamen des Diensts. Dieser Parameter kann NULL sein, wenn nServices 0 ist.

Rückgabewert

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

Wert	Bedeutung
ERROR_SUCCESS 0	Die angegebenen Ressourcen wurden registriert.
ERROR_SEM_TIMEOUT 121	Eine Neustart-Manager-Funktion konnte in der zugewiesenen Zeit keinen Registrierungsschreibmutex abrufen. Ein Systemneustart wird empfohlen, da bei der weiteren Verwendung des Neustart-Managers wahrscheinlich ein Fehler auftritt.
ERROR_BAD_ARGUMENTS 160	Mindestens ein Argument ist falsch. Dieser Fehlerwert wird von der Funktion Neustart-Manager zurückgegeben, wenn ein NULL-Zeiger oder 0 in einem Parameter übergeben wird, der einen Ungleich-NULL- und ungleich null-Wert 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, da nicht genügend Arbeitsspeicher verfügbar war.
ERROR_INVALID_HANDLE 6	Für das angegebene Handle ist keine Restart Manager-Sitzung vorhanden.

Hinweise

Jeder Aufruf der RmRegisterResources-Funktion führt relativ teure Schreibvorgänge aus. Rufen Sie diese Funktion nicht einmal pro Datei auf, sondern gruppieren Sie verwandte Dateien in Komponenten zusammen, und registrieren Sie diese zusammen.

Anforderungen

Anforderung	Wert
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

Share via