Função RestartDialogEx (shlobj_core.h)

[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 RestartDialogEx(
  [in, optional] HWND   hwnd,
  [in, optional] PCWSTR pszPrompt,
                 DWORD  dwReturn,
                 DWORD  dwReasonCode
);

Parâmetros

[in, optional] hwnd

Digite: HWND

Um identificador para a janela pai.

[in, optional] pszPrompt

Tipo: PCWSTR

Uma cadeia de caracteres terminada em nulo que contém o texto exibido na caixa de diálogo para solicitar 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. 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.

dwReasonCode

Tipo: DWORD

Windows XP:Especifica o motivo para iniciar o desligamento. Para obter mais informações, consulte Códigos de motivo de desligamento do sistema.

Windows 2000: Esse parâmetro é ignorado.

Valor retornado

Tipo: int

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

Requisitos