Funzione SetupPromptReboot (setupapi.h)
[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. SetupAPI non deve più essere usato per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione di applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.
La funzione SetupPromptReboot chiede all'utente se vuole riavviare il sistema, facoltativamente dipende dal fatto che i file in una coda di file di commit siano in uso durante un'operazione di file. Se l'utente risponde "sì" al prompt, l'arresto viene avviato prima che questa routine venga restituita.
Sintassi
WINSETUPAPI INT SetupPromptReboot(
[in] HSPFILEQ FileQueue,
[in] HWND Owner,
[in] BOOL ScanOnly
);
Parametri
[in] FileQueue
Puntatore facoltativo a un handle alla coda di file in base alla quale basare la decisione su se è necessario l'arresto. Se FileQueue non è specificato, SetupPromptReboot presuppone che l'arresto sia necessario e chiede all'utente cosa fare.
[in] Owner
Handle per la finestra padre per le finestre create da questa funzione.
[in] ScanOnly
Indica se richiedere all'utente se viene chiamato SetupPromptReboot .
Se TRUE, l'utente non viene mai chiesto di riavviare e l'arresto del sistema non viene avviato. In questo caso, è necessario specificare FileQueue . Se FALSE, l'utente viene chiesto di riavviare, come descritto in precedenza.
Usare ScanOnly per determinare se l'arresto è necessario separatamente dall'avvio di un arresto.
Valore restituito
La funzione restituisce una combinazione dei flag seguenti o –1 se si verifica un errore.
Per informazioni dettagliate sull'errore, chiamare GetLastError.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | setupapi.h |
| Libreria | Setupapi.lib |
| DLL | Setupapi.dll |