Compartilhar via

Função RmStartSession (restartmanager.h)

  • Artigo

Inicia uma nova sessão do Gerenciador de Reinicialização. No máximo 64 sessões do Gerenciador de Reinicialização por sessão de usuário podem ser abertas no sistema ao mesmo tempo. Quando essa função inicia uma sessão, ela retorna um identificador de sessão e uma chave de sessão que podem ser usados em chamadas subsequentes para a API do Gerenciador de Reinicialização.

Sintaxe

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

Parâmetros

[out] pSessionHandle

Um ponteiro para o identificador de uma sessão do Gerenciador de Reinicialização. O identificador de sessão pode ser passado em chamadas subsequentes para a API do Gerenciador de Reinicialização.

dwSessionFlags

Reservado. Esse parâmetro deve ser 0.

[out] strSessionKey

Uma cadeia de caracteres terminada em nulo que contém a chave de sessão para a nova sessão. A cadeia de caracteres deve ser alocada antes de chamar a função RmStartSession .

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_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
160
 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 requer um valor não nulo e diferente de zero.
ERROR_MAX_SESSIONS_REACHED
353
 O número máximo de sessões foi atingido.
ERROR_WRITE_FAULT
29
 O sistema não pode gravar no dispositivo especificado.
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 RmStartSession retornará um erro se já existir uma sessão com a mesma chave de sessão.

A função RmStartSession deve ser chamada pelo instalador primário que controla a interface do usuário ou que controla a sequência de instalação de vários patches em uma atualização.

Um instalador secundário pode ingressar em uma sessão existente do Gerenciador de Reinicialização chamando a função RmJoinSession com o identificador de sessão e a chave de sessão retornados da chamada de função RmStartSession do instalador primário.

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

RmJoinSession