RmJoinSession-Funktion (restartmanager.h)

Artikel
03/01/2024

Verknüpft ein sekundäres Installationsprogramm mit einer vorhandenen Restart Manager-Sitzung. Diese Funktion muss mit einem Sitzungsschlüssel aufgerufen werden, der nur vom primären Installationsprogramm abgerufen werden kann, das die Sitzung gestartet hat. Ein gültiger Sitzungsschlüssel ist erforderlich, um eine der Funktionen des Neustart-Managers zu verwenden. Nachdem ein sekundäres Installationsprogramm eine Sitzung hinzugefügt hat, kann es die RmRegisterResources-Funktion aufrufen, um Ressourcen zu registrieren.

Syntax

DWORD RmJoinSession(
  [out] DWORD          *pSessionHandle,
  [in]  const WCHAR [] strSessionKey
);

Parameter

[out] pSessionHandle

Ein Zeiger auf das Handle einer vorhandenen Restart Manager-Sitzung.

[in] strSessionKey

Eine NULL-Zeichenfolge, die den Sitzungsschlüssel einer vorhandenen Sitzung enthält.

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 Funktion wurde erfolgreich abgeschlossen.
ERROR_SESSION_CREDENTIAL_CONFLICT 1219	Der Sitzungsschlüssel kann nicht überprüft werden.
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 22	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_MAX_SESSIONS_REACHED 353	Die maximale Anzahl an Sitzungen wurde erreicht.
ERROR_OUTOFMEMORY 14	Ein Neustart-Manager-Vorgang konnte nicht abgeschlossen werden, da nicht genügend Arbeitsspeicher verfügbar war.

Hinweise

Die RmJoinSession-Funktion verknüpft ein sekundäres Installationsprogramm mit einer vorhandenen Restart Manager-Sitzung. Dies ist in der Regel ein Installationsprogramm, das die Benutzeroberfläche nicht steuert und entweder im Prozess oder außerhalb des primären Installers ausgeführt werden kann. Nur das primäre Installationsprogramm kann die RmStartSession-Funktion aufrufen. Dies ist in der Regel die Anwendung, die die Benutzeroberfläche steuert oder die Installationssequenz mehrerer Patches in einem Update steuert.

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

Weitere Informationen

RmEndSession

RmStartSession

Freigeben über