Fonction SetupDiDeleteDeviceInfo (setupapi.h)
La fonction SetupDiDeleteDeviceInfo supprime un élément d’informations sur l’appareil d’un jeu d’informations d’appareil. Cette fonction ne supprime pas l’appareil réel.
Syntaxe
WINSETUPAPI BOOL SetupDiDeleteDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData
);
Paramètres
[in] DeviceInfoSet
Handle du jeu d’informations sur l’appareil qui contient l’élément d’informations sur l’appareil à supprimer.
[in] DeviceInfoData
Pointeur vers une structure de SP_DEVINFO_DATA qui représente l’élément d’informations sur l’appareil dans DeviceInfoSet à supprimer.
Valeur retournée
La fonction retourne TRUE si elle réussit. Sinon, il retourne FALSE et l’erreur journalisée peut être récupérée avec un appel à GetLastError.
Remarques
Si l’élément d’informations sur l’appareil spécifié est en cours d’utilisation (par exemple, par une page de l’Assistant), la fonction échoue. Dans ce cas, un appel à GetLastError retourne ERROR_DEVINFO_DATA_LOCKED. Cela se produit si un handle d’une page d’Assistant est récupéré avec un appel à SetupDiGetWizardPage avec cet élément d’informations sur l’appareil spécifié et l’indicateur DIWP_FLAG_USE_DEVINFO_DATA défini. Pour supprimer cet élément d’informations sur l’appareil, vous devez d’abord fermer le handle HPROPSHEETPAGE de l’Assistant.
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 |