Compartir a través de

Función RmJoinSession (restartmanager.h)

  • Artículo

Une un instalador secundario a una sesión existente del Administrador de reinicio. Se debe llamar a esta función con una clave de sesión que solo se puede obtener del instalador principal que inició la sesión. Se requiere una clave de sesión válida para usar cualquiera de las funciones del Administrador de reinicio. Una vez que un instalador secundario se una a una sesión, puede llamar a la función RmRegisterResources para registrar recursos.

Sintaxis

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

Parámetros

[out] pSessionHandle

Puntero al identificador de una sesión del Administrador de reinicio existente.

[in] strSessionKey

Cadena terminada en null que contiene la clave de sesión de una sesión existente.

Valor devuelto

Este es el error más reciente recibido. La función puede devolver uno de los códigos de error del sistema definidos en Winerror.h.

Valor Significado
ERROR_SUCCESS
0
 Si se devuelve este valor, significa que la función se completó correctamente.
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 No se puede validar la clave de sesión.
ERROR_SEM_TIMEOUT
121
 Una función Restart Manager no pudo obtener una exclusión mutua de escritura del Registro en el tiempo asignado. Se recomienda reiniciar el sistema porque es probable que se produzca un error en el uso adicional del Administrador de reinicios.
ERROR_BAD_ARGUMENTS
22
 Uno o más argumentos son incorrectos. La función Restart Manager devuelve este valor de error si se pasa un puntero NULL o 0 en un parámetro que requiere un valor distinto de NULL y distinto de cero.
ERROR_WRITE_FAULT
29
 Una operación no pudo leer o escribir en el registro.
ERROR_MAX_SESSIONS_REACHED
353
 Se ha alcanzado el número máximo de sesiones.
ERROR_OUTOFMEMORY
14
 No se pudo completar una operación del Administrador de reinicio porque no había suficiente memoria disponible.

Comentarios

La función RmJoinSession une un instalador secundario a una sesión existente de Restart Manager. Normalmente, se trata de un instalador que no controla la interfaz de usuario y que se puede ejecutar en proceso o fuera del proceso del instalador principal. Solo el instalador principal puede llamar a la función RmStartSession y suele ser la aplicación que controla la interfaz de usuario o que controla la secuencia de instalación de varias revisiones en una actualización.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado restartmanager.h
Library Rstrtmgr.lib
Archivo DLL Rstrtmgr.dll

Consulte también

RmEndSession

RmStartSession