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

Vedi anche

Funzioni

Panoramica

SetupPromptForDisk