функция CM_Setup_DevNode (cfgmgr32.h)
Функция CM_Setup_DevNode перезапускает экземпляр устройства, который не запущен, так как возникла проблема с конфигурацией устройства.
Синтаксис
CMAPI CONFIGRET CM_Setup_DevNode(
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Параметры
[in] dnDevInst
Дескриптор экземпляра устройства, привязанный к локальной системе.
[in] ulFlags
Одно из следующих значений флага:
CM_SETUP_DEVNODE_READY
Перезапускает экземпляр устройства, который не запущен из-за проблемы с конфигурацией устройства.
CM_SETUP_DEVNODE_RESET (Windows XP и более поздние версии Windows)
Сбрасывает экземпляр устройства, для которого установлен флаг состояния устройства без перезапуска. Флаг состояния устройства не перезапускается, если устройство удаляется путем вызова CM_Query_And_Remove_SubTree или CM_Query_And_Remove_SubTree_Ex и указания флага CM_REMOVE_NO_RESTART.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибки с префиксом "CR_", определенный в Cfgmgr32.h.
Комментарии
Приложения установки устройств должны использовать DIF_PROPERTYCHANGE запрос на перезапуск устройства вместо этой функции. Запрос DIF_PROPERTYCHANGE можно использовать для включения, отключения, перезапуска, остановки или изменения свойств устройства.
Если у экземпляра устройства нет проблем и он уже запущен, CM_Setup_DevNode возвращается без изменения состояния экземпляра устройства.
Вызовите CM_Get_DevNode_Status или CM_Get_DevNode_Status_Ex , чтобы определить состояние и код проблемы для экземпляра устройства.
Требования
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Универсальное |
| Верхняя часть | cfgmgr32.h (включая Cfgmgr32.h) |
| Библиотека | Cfgmgr32.lib; OneCoreUAP.lib в Windows 10 |
| DLL | CfgMgr32.dll |