Função SetupPromptReboot (setupapi.h)
[Essa função está disponível para uso nos sistemas operacionais indicados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. SetupAPI não deve mais ser usado para instalar aplicativos. Em vez disso, use o Windows Installer para desenvolver instaladores de aplicativos. SetupAPI continua a ser usado para instalar drivers de dispositivo.]
A função SetupPromptReboot pergunta ao usuário se ele deseja reinicializar o sistema, opcionalmente dependendo se algum arquivo em uma fila de arquivos confirmados estava em uso durante uma operação de arquivo. Se o usuário responder "sim" ao prompt, o desligamento será iniciado antes que essa rotina retorne.
Sintaxe
WINSETUPAPI INT SetupPromptReboot(
[in] HSPFILEQ FileQueue,
[in] HWND Owner,
[in] BOOL ScanOnly
);
Parâmetros
[in] FileQueue
Ponteiro opcional para um identificador para a fila de arquivos na qual basear a decisão sobre se o desligamento é necessário. Se FileQueue não for especificado, SetupPromptReboot assumirá que o desligamento é necessário e perguntará ao usuário o que fazer.
[in] Owner
Manipule para que a janela pai possua janelas criadas por essa função.
[in] ScanOnly
Indica se o usuário será solicitado ou não quando SetupPromptReboot for chamado.
Se TRUE, o usuário nunca será questionado sobre a reinicialização e o desligamento do sistema não será iniciado. Nesse caso, FileQueue deve ser especificado. Se FALSE, o usuário será questionado sobre a reinicialização, conforme descrito anteriormente.
Use ScanOnly para determinar se o desligamento é necessário separadamente de realmente iniciar um desligamento.
Retornar valor
A função retornará uma combinação dos sinalizadores a seguir ou –1 se ocorrer um erro.
Para obter informações de erro estendidas, chame GetLastError.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | setupapi.h |
| Biblioteca | Setupapi.lib |
| DLL | Setupapi.dll |