Поделиться через


функция CM_Uninstall_DevNode (cfgmgr32.h)

Функция CM_Uninstall_DevNode удаляет все постоянное состояние, связанное с экземпляром устройства.

Синтаксис

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

Параметры

[in] dnDevInst

Дескриптор экземпляра устройства, привязанный к локальному компьютеру.

[in] ulFlags

Зарезервировано. Необходимо задать нулевое значение.

Возвращаемое значение

Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с префиксом CR_, определенных в Cfgmgr32.h.

Комментарии

Эта функция удаляет устройство без отправки запроса IRP_MN_QUERY_REMOVE_DEVICE или вызова установщиков классов или совместного установщика. Если приложение будет выполняться только на целевой платформе рабочего стола, вместо вызова CM_Uninstall_DevNode приложение должно удалить устройство, вызвав SetupDiCallClassInstaller с DIF_REMOVE кодом или вызвав DiUninstallDevice.

Чтобы вызвать эту функцию, используйте следующую последовательность:

  1. Проверьте, возвращает ли CM_Get_DevNode_Status успешное выполнение. Это означает, что устройство присутствует.
  2. Если устройство присутствует, вызовите CM_Query_And_Remove_SubTree.
  3. Вызов CM_Uninstall_DevNode.

Требования

   
Минимальная версия клиента Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа Универсальное
Верхняя часть cfgmgr32.h (включая Cfgmgr32.h)
Библиотека Cfgmgr32.lib; OneCoreUAP.lib в Windows 10
DLL CfgMgr32.dll

См. также раздел

SetupDiCallClassInstaller