SetupDiRemoveDevice, fonction (setupapi.h)
La fonction SetupDiRemoveDevice est le gestionnaire par défaut pour la demande d’installation DIF_REMOVE .
Syntaxe
WINSETUPAPI BOOL SetupDiRemoveDevice(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVINFO_DATA DeviceInfoData
);
Paramètres
[in] DeviceInfoSet
Handle d’un jeu d’informations d’appareil pour le système local qui contient un élément d’informations sur l’appareil qui représente l’appareil à supprimer.
[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 DeviceInfoSet. DevInst peut être mis à jour avec une nouvelle valeur de handle lors du retour. S’il s’agit d’une suppression globale ou de la dernière suppression spécifique au profil matériel, toutes les traces de l’appareil instance sont supprimées du Registre et le handle est NULL.
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
SetupDiRemoveDevice supprime l’appareil du système. Il supprime les clés de Registre matérielles et logicielles de l’appareil et toutes les clés de Registre spécifiques au profil matériel (clés de Registre spécifiques à la configuration). Cette fonction arrête dynamiquement l’appareil si son DevInst est actif et s’il s’agit d’une suppression globale ou de la dernière suppression spécifique à la configuration. Si l’appareil ne peut pas être arrêté dynamiquement, les indicateurs sont définis dans le bloc Paramètre d’installation du jeu d’informations sur l’appareil, ce qui entraîne l’invite de l’utilisateur à redémarrer l’ordinateur.
La suppression de l’appareil est globale pour tous les profils matériels ou spécifique à un profil matériel, comme spécifié par le membre Étendue de la structure SP_REMOVEDEVICE_PARAMS qui fournit les paramètres d’installation de classe pour la demande de DIF_REMOVE. La suppression spécifique à la configuration convient uniquement aux appareils énumérés par la racine et ne doit être demandée que par le code système.
L’appelant de SetupDiRemoveDevice 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 |