fonction CM_Uninstall_DevNode (cfgmgr32.h)

Article
08/22/2023

La fonction CM_Uninstall_DevNode supprime tous les états persistants associés à un instance d’appareil.

Syntaxe

CMAPI CONFIGRET CM_Uninstall_DevNode(
  [in] DEVNODE dnDevInst,
  [in] ULONG   ulFlags
);

Paramètres

[in] dnDevInst

Le instance de l’appareil qui est lié à l’ordinateur local.

[in] ulFlags

Réservé. Doit être défini sur zéro.

Valeur retournée

Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, il retourne l’un des codes d’erreur CR_ préfixés définis dans Cfgmgr32.h.

Remarques

Cette fonction désinstalle l’appareil sans envoyer de demande de IRP_MN_QUERY_REMOVE_DEVICE ou appeler des programmes d’installation de classe ou des co-programmes d’installation. Si votre application s’exécute uniquement sur une plateforme cible de bureau, au lieu d’appeler CM_Uninstall_DevNode, l’application doit désinstaller l’appareil en appelant SetupDiCallClassInstaller avec le code DIF_REMOVE ou en appelant DiUninstallDevice.

Utilisez la séquence suivante pour appeler cette fonction :

Vérifiez si CM_Get_DevNode_Status retourne la réussite. Cela signifie que l’appareil est présent.
Si l’appareil est présent, appelez CM_Query_And_Remove_SubTree.
Appelez CM_Uninstall_DevNode.

Configuration requise


Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque	Cfgmgr32.lib; OneCoreUAP.lib sur Windows 10
DLL	CfgMgr32.dll

Voir aussi

SetupDiCallClassInstaller

Partager via