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

Voir aussi

SetupDiCreateDeviceInfo

SetupDiEnumDeviceInfo

SetupDiGetWizardPage

SetupDiOpenDeviceInfo