Fonction SetupPromptReboot (setupapi.h)
[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour l’installation d’applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour l’installation des pilotes de périphérique.]
La fonction SetupPromptReboot demande à l’utilisateur s’il souhaite redémarrer le système, en fonction éventuellement si des fichiers d’une file d’attente de fichiers validées ont été utilisés pendant une opération de fichier. Si l’utilisateur répond « oui » à l’invite, l’arrêt est lancé avant le retour de cette routine.
Syntaxe
WINSETUPAPI INT SetupPromptReboot(
[in] HSPFILEQ FileQueue,
[in] HWND Owner,
[in] BOOL ScanOnly
);
Paramètres
[in] FileQueue
Pointeur facultatif vers un handle vers la file d’attente de fichiers sur lequel baser la décision quant à la nécessité d’un arrêt. Si FileQueue n’est pas spécifié, SetupPromptReboot suppose que l’arrêt est nécessaire et demande à l’utilisateur ce qu’il doit faire.
[in] Owner
Gérez pour que la fenêtre parente soit propriétaire des fenêtres créées par cette fonction.
[in] ScanOnly
Indique s’il faut ou non inviter l’utilisateur à l’appel de SetupPromptReboot .
Si la valeur est TRUE, l’utilisateur n’est jamais invité à redémarrer et l’arrêt du système n’est pas lancé. Dans ce cas, FileQueue doit être spécifié. Si la valeur est FALSE, l’utilisateur est invité à redémarrer, comme décrit précédemment.
Utilisez ScanOnly pour déterminer si l’arrêt est nécessaire séparément de l’initiation d’un arrêt.
Valeur retournée
La fonction retourne une combinaison des indicateurs suivants ou –1 si une erreur se produit.
Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | setupapi.h |
| Bibliothèque | Setupapi.lib |
| DLL | Setupapi.dll |