Compartilhar via

Função RmJoinSession (restartmanager.h)

  • Artigo

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