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

Confira também

Funções

Visão geral

SetupPromptForDisk