Функция SetupDiUnremoveDevice (setupapi.h)

Функция SetupDiUnremoveDevice является обработчиком по умолчанию для запроса на установку DIF_UNREMOVE.

Синтаксис

WINSETUPAPI BOOL SetupDiUnremoveDevice(
  [in]      HDEVINFO         DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA DeviceInfoData
);

Параметры

[in] DeviceInfoSet

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

[in, out] DeviceInfoData

Указатель на структуру SP_DEVINFO_DATA , указывающую элемент сведений об устройстве в DeviceInfoSet. Это параметр IN-OUT, так как DeviceInfoData.При возврате в DevInst может быть обновлено новое значение дескриптора.

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

Функция возвращает ЗНАЧЕНИЕ TRUE , если оно выполнено успешно. В противном случае возвращается значение FALSE , а зарегистрированная ошибка может быть получена вызовом Метода GetLastError.

Комментарии

SetupDiUnremoveDevice восстанавливает устройство в аппаратный профиль. Эта функция запускает устройство, если это возможно, или устанавливает флаг в параметрах установки устройства, что в конечном итоге вызывает запрос на завершение работы системы.

Примечание Только установщик класса должен вызывать SetupDiUnremoveDevice и только в тех ситуациях, когда установщик класса должен выполнять операции неустранимая операции устройства после того , как SetupDiUnremoveDevice завершит операцию отмены удаления устройства по умолчанию. В таких ситуациях установщик класса должен напрямую вызывать SetupDiUnremoveDevice , когда установщик обрабатывает запрос DIF_UNREMOVE. Дополнительные сведения о вызове обработчика по умолчанию см. в разделе Вызов обработчиков кода DIF по умолчанию.

 

Восстанавливаемые устройства должны иметь параметры установки класса для DIF_UNREMOVE в противном случае функция завершается сбоем и GetLastError возвращает ERROR_NO_CLASSINSTALL_PARAMS.

DeviceInfoSet должен содержать только элементы на локальном компьютере.

Вызывающий объект SetupDiUnremoveDevice должен быть членом группы Администраторы.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	setupapi.h (включая Setupapi.h)
Библиотека	Setupapi.lib
DLL	Setupapi.dll

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

DIF_UNREMOVE

SP_DEVINFO_DATA

SetupDiRemoveDevice