Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Inicia uma nova sessão do Restart Manager. Um máximo de 64 sessões do Restart Manager 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 Restart Manager. 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 de tamanho CCH_RM_SESSION_KEY + 1 deve ser alocada antes de chamar a função RmStartSession .
Valor de retorno
Este é o erro mais recente recebido. A função pode retornar um dos códigos de erro do sistema definidos em Winerror.h.
| Valor | Significado |
|---|---|
|
A função foi concluída com êxito. |
|
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á. |
|
Um ou mais argumentos não estão corretos. Esse valor de erro será retornado pela função Restart Manager se um ponteiro NULL ou 0 for passado em um parâmetro que requer um valor não nulo e não zero. |
|
O número máximo de sessões foi atingido. |
|
O sistema não pode gravar no dispositivo especificado. |
|
Uma operação do Restart Manager não pôde ser concluída porque não havia memória suficiente disponível. |
Observações
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 Restart Manager chamando a função RmJoinSession com o identificador de sessão e a chave de sessão retornadas da chamada de função RmStartSession do instalador primário.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo suportado | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo compatível | Windows Server 2008 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino | Windows |
| cabeçalho | restartmanager.h |
| Biblioteca | Rstrtmgr.lib |
| de DLL | Rstrtmgr.dll |