Partager via

Fonction SetupPromptReboot (setupapi.h)

  • Article

[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

Voir aussi

Fonctions

Vue d'ensemble

SetupPromptForDisk