CM_Uninstall_DevNode-Funktion (cfgmgr32.h)

  • Artikel

Die CM_Uninstall_DevNode-Funktion entfernt den gesamten persistenten Zustand, der einem Gerät instance zugeordnet ist.

Syntax

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

Parameter

[in] dnDevInst

Gerät instance Handle, das an den lokalen Computer gebunden ist.

[in] ulFlags

Reserviert. Muss auf 0 festgelegt werden.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der CR_-Präfix-Fehlercodes zurückgegeben, die in Cfgmgr32.h definiert sind.

Hinweise

Diese Funktion deinstalliert das Gerät, ohne eine IRP_MN_QUERY_REMOVE_DEVICE Anforderung zu senden oder Klasseninstallationsprogramme oder Co-Installer aufzurufen. Wenn Ihre Anwendung nur auf einer Zielplattform von Desktop ausgeführt wird, anstatt CM_Uninstall_DevNode aufzurufen, sollte die Anwendung das Gerät deinstallieren, indem sie SetupDiCallClassInstaller mit dem DIF_REMOVE Code aufruft oder DiUninstallDevice aufruft.

Verwenden Sie die folgende Sequenz, um diese Funktion aufzurufen:

  1. Überprüfen Sie , ob CM_Get_DevNode_Status erfolgreich ist. Dies bedeutet, dass das Gerät vorhanden ist.
  2. Wenn das Gerät vorhanden ist, rufen Sie CM_Query_And_Remove_SubTree auf.
  3. Rufen Sie CM_Uninstall_DevNode auf.

Anforderungen

   
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Universell
Header cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek Cfgmgr32.lib; OneCoreUAP.lib auf Windows 10
DLL CfgMgr32.dll

Weitere Informationen

SetupDiCallClassInstaller