CM_Uninstall_DevNode-Funktion (cfgmgr32.h)
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:
- Überprüfen Sie , ob CM_Get_DevNode_Status erfolgreich ist. Dies bedeutet, dass das Gerät vorhanden ist.
- Wenn das Gerät vorhanden ist, rufen Sie CM_Query_And_Remove_SubTree auf.
- 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 |