SetupDiUnremoveDevice, fonction (setupapi.h)

Article
03/01/2024

La fonction SetupDiUnremoveDevice est le gestionnaire par défaut pour la demande d’installation DIF_UNREMOVE .

Syntaxe

WINSETUPAPI BOOL SetupDiUnremoveDevice(
  [in]      HDEVINFO         DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA DeviceInfoData
);

Paramètres

[in] DeviceInfoSet

Handle vers un jeu d’informations d’appareil pour le système local qui contient un élément d’informations sur l’appareil qui représente un appareil à restaurer et à redémarrer.

[in, out] DeviceInfoData

Pointeur vers une structure de SP_DEVINFO_DATA qui spécifie l’élément d’informations sur l’appareil dans DeviceInfoSet. Il s’agit d’un paramètre IN-OUT, car DeviceInfoData.DevInst peut être mis à jour avec une nouvelle valeur de handle au retour.

Valeur retournée

La fonction retourne TRUE si elle réussit. Sinon, elle retourne FALSE et l’erreur journalisée peut être récupérée par un appel à GetLastError.

Remarques

SetupDiUnremoveDevice restaure un appareil sur un profil matériel. Cette fonction démarre l’appareil, si possible, ou elle définit un indicateur dans les paramètres d’installation de l’appareil qui finit par inviter l’utilisateur à arrêter le système.

Note Seul un programme d’installation de classe doit appeler SetupDiUnremoveDevice et uniquement dans les situations où le programme d’installation de classe doit effectuer des opérations de suppression de l’appareil une fois que SetupDiUnremoveDevice a terminé l’opération de suppression de l’appareil par défaut. Dans de telles situations, le programme d’installation de classe doit appeler directement SetupDiUnremoveDevice quand le programme d’installation traite une demande de DIF_UNREMOVE. Pour plus d’informations sur l’appel du gestionnaire par défaut, consultez Appel des gestionnaires de code DIF par défaut.

L’appareil en cours de restauration doit avoir des paramètres d’installation de classe pour DIF_UNREMOVE ou la fonction échoue et GetLastError retourne ERROR_NO_CLASSINSTALL_PARAMS.

DeviceInfoSet doit contenir uniquement des éléments sur l’ordinateur local.

L’appelant de SetupDiUnremoveDevice doit être membre du groupe Administrateurs.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	setupapi.h (inclure Setupapi.h)
Bibliothèque	Setupapi.lib
DLL	Setupapi.dll

Voir aussi

DIF_UNREMOVE

SP_DEVINFO_DATA

SetupDiRemoveDevice

Partager via