Função RestartDialog (shlobj_core.h)

  • Artigo

[Essa função está disponível por meio do Windows XP Service Pack 2 (SP2) e do Windows Server 2003. Ele pode estar alterado ou indisponível nas versões subsequentes do Windows.]

Exibe uma caixa de diálogo que solicita que o usuário reinicie o Windows. Quando o usuário clica no botão, a função chama ExitWindowsEx para tentar reiniciar o Windows.

Sintaxe

int RestartDialog(
  [in, optional] HWND   hwnd,
  [in, optional] PCWSTR pszPrompt,
                 DWORD  dwReturn
);

Parâmetros

[in, optional] hwnd

Digite: HWND

Um identificador para a janela pai.

[in, optional] pszPrompt

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que contém o texto exibido na caixa de diálogo que solicita ao usuário.

dwReturn

Tipo: DWORD

Os sinalizadores que especificam o tipo de desligamento.

Esse parâmetro deve incluir um dos valores a seguir.

EWX_LOGOFF

Desliga todos os processos em execução no contexto de segurança do processo que chamou essa função e, em seguida, registra o usuário desativado.

EWX_POWEROFF

Desliga o sistema e desativa a energia. O sistema deve dar suporte ao recurso de desligar. O processo de chamada deve ter o privilégio SE_SHUTDOWN_NAME . Para obter mais informações, consulte ExitWindowsEx.

EWX_REBOOT

Desliga o sistema e reinicia o sistema. O processo de chamada deve ter o privilégio SE_SHUTDOWN_NAME . Para obter mais informações, consulte ExitWindowsEx.

EWX_SHUTDOWN

Desliga o sistema para um ponto no qual é seguro desligar a energia. Neste ponto, todos os buffers de arquivo foram liberados para o disco e todos os processos em execução foram interrompidos. Se o sistema der suporte ao recurso de desligar, a energia também será desativada. O processo de chamada deve ter o privilégio SE_SHUTDOWN_NAME . Para obter mais informações, consulte ExitWindowsEx.

Opcionalmente, esse parâmetro pode incluir os valores a seguir.

EWX_FORCE

Força os processos a serem encerrados. Quando esse sinalizador é definido, o sistema não envia o WM_QUERYENDSESSION e WM_ENDSESSION mensagens. Isso pode fazer com que os aplicativos percam dados. Portanto, você só deve usar esse sinalizador em uma emergência.

EWX_FORCEIFHUNG

Força os processos a serem encerrados se eles não responderem à mensagem WM_QUERYENDSESSION ou WM_ENDSESSION . Esse sinalizador será ignorado se EWX_FORCE for usado.

Retornar valor

Tipo: int

Retorna o identificador do botão que foi pressionado para fechar a caixa de diálogo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h (inclua Shlobj.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 5.0 ou posterior)
Conjunto de APIs ext-ms-win-shell32-l1-2-1 (introduzido no Windows 10, versão 10.0.10240)