Función RmStartSession (restartmanager.h)

  • Artículo

Inicia una nueva sesión del Administrador de reinicio. Se puede abrir un máximo de 64 sesiones del Administrador de reinicio por sesión de usuario en el sistema al mismo tiempo. Cuando esta función inicia una sesión, devuelve un identificador de sesión y una clave de sesión que se pueden usar en llamadas posteriores a la API de Restart Manager.

Sintaxis

DWORD RmStartSession(
  [out] DWORD    *pSessionHandle,
        DWORD    dwSessionFlags,
  [out] WCHAR [] strSessionKey
);

Parámetros

[out] pSessionHandle

Puntero al identificador de una sesión del Administrador de reinicio. El identificador de sesión se puede pasar en llamadas posteriores a la API de Restart Manager.

dwSessionFlags

Reservado. Este parámetro debe ser 0.

[out] strSessionKey

Cadena terminada en null que contiene la clave de sesión a la nueva sesión. La cadena debe asignarse antes de llamar a la función RmStartSession .

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_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 posterior del Administrador de reinicios.
ERROR_BAD_ARGUMENTS
160
 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_MAX_SESSIONS_REACHED
353
 Se ha alcanzado el número máximo de sesiones.
ERROR_WRITE_FAULT
29
 El sistema no puede escribir en el dispositivo especificado.
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 RmStartSession devuelve un error si ya existe una sesión con la misma clave de sesión.

El instalador principal debe llamar a la función RmStartSession que controla la interfaz de usuario o que controla la secuencia de instalación de varias revisiones en una actualización.

Un instalador secundario puede unirse a una sesión existente del Administrador de reinicio llamando a la función RmJoinSession con el identificador de sesión y la clave de sesión devueltas desde la llamada de función RmStartSession del instalador principal.

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

RmJoinSession