Fonction SetupDiRemoveDeviceInterface (setupapi.h)
La fonction SetupDiRemoveDeviceInterface supprime une interface d’appareil inscrite du système.
Syntaxe
WINSETUPAPI BOOL SetupDiRemoveDeviceInterface(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData
);
Paramètres
[in] DeviceInfoSet
Pointeur vers le jeu d’informations sur l’appareil qui contient l’interface de l’appareil à supprimer. Ce handle est généralement retourné par SetupDiGetClassDevs.
[in, out] DeviceInterfaceData
Pointeur vers une structure de SP_DEVICE_INTERFACE_DATA qui spécifie l’interface de l’appareil dans DeviceInfoSet à supprimer. Ce pointeur est généralement retourné par SetupDiEnumDeviceInterfaces.
Une fois l’interface supprimée, cette fonction définit l’indicateur SPINT_REMOVED dans DeviceInterfaceData. Indicateurs. Il efface également l’indicateur SPINT_ACTIVE, mais sachez que cet indicateur aurait déjà dû être effacé avant l’appel de cette fonction.
Valeur retournée
SetupDiRemoveDeviceInterface retourne TRUE si la fonction s’est terminée sans erreur. Si la fonction a terminé avec une erreur, elle retourne FALSE et le code d’erreur de l’échec peut être récupéré en appelant GetLastError.
Remarques
L’appelant de cette fonction doit être membre du groupe Administrateurs.
SetupDiRemoveDeviceInterface supprime l’interface d’appareil spécifiée du système. Cela inclut la suppression de la clé de Registre associée.
Appelez SetupDiDeleteDeviceInterfaceData pour supprimer l’interface d’une liste d’informations d’appareil.
Une interface d’appareil doit être désactivée pour être supprimée. Si l’interface est activée, cette fonction échoue et GetLastError retourne ERROR_DEVICE_INTERFACE_ACTIVE. Désactivez une interface à l’aide du mécanisme spécifique à l’interface fourni (par exemple, un IOCTL). Si l’appelant n’a aucun moyen de désactiver une interface et que l’interface doit être supprimée, l’appelant doit arrêter l’appareil sous-jacent à l’aide de SetupDiChangeState. L’arrêt de l’appareil désactive toutes les interfaces exposées par l’appareil.
Configuration requise
| Client minimal pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | Bureau |
| En-tête | setupapi.h (inclure Setupapi.h) |
| Bibliothèque | Setupapi.lib |
| DLL | Setupapi.dll |