RmRegisterResources-Funktion (restartmanager.h)
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 |
---|---|
|
Die angegebenen Ressourcen wurden registriert. |
|
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. |
|
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. |
|
Ein Vorgang konnte weder lesen noch in die Registrierung schreiben. |
|
Ein Neustart-Manager-Vorgang konnte nicht abgeschlossen werden, da nicht genügend Arbeitsspeicher verfügbar war. |
|
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 |