Função RmJoinSession (restartmanager.h)

Une um instalador secundário a uma sessão existente do Gerenciador de Reinicialização. Essa função deve ser chamada com uma chave de sessão que só pode ser obtida do instalador primário que iniciou a sessão. Uma chave de sessão válida é necessária para usar qualquer uma das funções do Gerenciador de Reinicialização. Depois que um instalador secundário ingressa em uma sessão, ele pode chamar a função RmRegisterResources para registrar recursos.

Sintaxe

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

Parâmetros

[out] pSessionHandle

Um ponteiro para o identificador de uma Sessão do Gerenciador de Reinicialização existente.

[in] strSessionKey

Uma cadeia de caracteres terminada em nulo que contém a chave de sessão de uma sessão existente.

Retornar valor

Esse é o erro mais recente recebido. A função pode retornar um dos códigos de erro do sistema definidos em Winerror.h.

Valor	Significado
ERROR_SUCCESS 0	A função foi concluída com êxito.
ERROR_SESSION_CREDENTIAL_CONFLICT 1219	A chave de sessão não pode ser validada.
ERROR_SEM_TIMEOUT 121	Uma função do Gerenciador de Reinicialização não pôde obter um mutex de gravação do Registro no tempo alocado. Uma reinicialização do sistema é recomendada porque o uso adicional do Gerenciador de Reinicialização provavelmente falhará.
ERROR_BAD_ARGUMENTS 22	Um ou mais argumentos não estão corretos. Esse valor de erro será retornado pela função Gerenciador de Reinicialização se um ponteiro NULL ou 0 for passado em um parâmetro que exija um valor não nulo e não zero.
ERROR_WRITE_FAULT 29	Uma operação não pôde ler ou gravar no registro.
ERROR_MAX_SESSIONS_REACHED 353	O número máximo de sessões foi atingido.
ERROR_OUTOFMEMORY 14	Uma operação do Gerenciador de Reinicialização não pôde ser concluída porque não havia memória suficiente disponível.

Comentários

A função RmJoinSession une um instalador secundário a uma sessão existente do Restart Manager. Normalmente, esse é um instalador que não controla a interface do usuário e pode executar em processo ou fora do processo do instalador primário. Somente o instalador primário pode chamar a função RmStartSession e esse normalmente é o aplicativo que controla a interface do usuário ou que controla a sequência de instalação de vários patches em uma atualização.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	restartmanager.h
Biblioteca	Rstrtmgr.lib
DLL	Rstrtmgr.dll

Confira também

RmEndSession

RmStartSession