Freigeben über


RmJoinSession-Funktion (restartmanager.h)

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