DIF_FINISHINSTALL_ACTION

Статья
06/15/2023

Запрос DIF_FINISHINSTALL_ACTION позволяет установщику выполнять действия завершения установки в интерактивном контексте администратора после завершения всех остальных операций установки устройства.

При отправке

В Windows 8 и более поздних версиях действия завершения установки не выполняются автоматически при установке устройства. Чтобы завершить установку устройства, пользователь должен нажать кнопку "Завершить установку программного обеспечения устройства" в центре уведомлений, чтобы завершить установку.

Дополнительные сведения см. в разделе Выполнение действий Finish-Install.

В Windows 7 процесс завершения установки выполняется только в контексте пользователя с учетными данными администратора в одно из следующих случаев:

При следующем входе пользователя с учетными данными администратора во время присоединения устройства.
При повторном подключении устройства.
При выборе пользователем пункта Проверить на наличие изменений оборудования в диспетчер устройств.

Если пользователь выполнил вход без прав администратора, Windows запрашивает у пользователя согласие и учетные данные для выполнения действий завершения установки в контексте администратора.

Кто обрабатывает

Совместный установщик класса	Может обрабатывать
Совместный установщик устройства	Может обрабатывать
Установщик класса	Может обрабатывать

Входные данные установщика

DeviceInfoSet
Дескриптор набора сведений об устройстве , содержащего устанавливаемое устройство.

DeviceInfoData
Указатель на структуру SP_DEVINFO_DATA , представляющую устанавливаемое устройство.

Параметры установки устройства
Существуют параметры установки устройства ( структура SP_DEVINSTALL_PARAMS ), связанные с DeviceInfoData.

Параметры установки класса
Нет

Выходные данные установщика

Параметры установки устройства
Установщик устанавливает флаг DI_NEEDREBOOT, если для завершения установки требуется перезагрузка системы.

Возвращаемое значение установщика

Установщик возвращает одно из значений, перечисленных в следующей таблице.

Возвращаемое значение	Значение
ERROR_DI_DO_DEFAULT	Установщик класса. Установщик не имеет действий по завершению установки, успешно выполнил действия завершения установки или определил, что он никогда не может успешно выполнить свои действия по завершению установки. Установка устройства должна выполнять обработку по умолчанию для запроса. Совместный установщик. Совместное установщики не должны возвращать этот код ошибки.
NO_ERROR	Установщик класса: установщик класса не должен возвращать этот код ошибки. Если установщик класса возвращает этот код ошибки, установка устройства не выполняет обработку по умолчанию для запроса. Совместный установщик. Установщик не имеет действий по завершению установки, успешно завершил действия по завершению установки или определил, что он никогда не может успешно завершить свои действия по установке.
Код ошибки Win32	Установщик класса или совместный установщик. Установщик обнаружил ошибку при обработке действия завершения установки, и установка устройства должна попытаться выполнить действия завершения установки при следующем перечислении устройства в контексте администратора.

ERROR_DI_DO_DEFAULT

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

Совместный установщик. Совместное установщики не должны возвращать этот код ошибки.

NO_ERROR

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

Совместный установщик. Установщик не имеет действий по завершению установки, успешно завершил действия по завершению установки или определил, что он никогда не может успешно завершить свои действия по установке.

Код ошибки Win32

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

Обработчик кода DIF по умолчанию

Windows 7 использует SetupDiFinishInstallAction.

Обработчик кода DIF по умолчанию отсутствует в Windows 8 и более поздних версиях, а setupDiFinishInstallAction удален.

Поскольку установка устройства не может определить на основе кода возврата ERROR_DI_DO_DEFAULT или кода возврата NO_ERROR, успешно ли выполнено действие завершения установки, установщик должен уведомить пользователя о состоянии действия завершения установки.

Дополнительные сведения о действиях завершения установки см. в разделах How Device Installation Processes Finish-Install Actions и Implementing Finish-Install Actions.

Общие сведения о кодах DIF см. в разделах Обработка кодов DIF и Вызов обработчиков кода DIF по умолчанию.

Требования

Версия	Поддерживается в Windows Vista и Windows 7.
Заголовок	Setupapi.h (включая Setupapi.h)

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

SetupDiFinishInstallAction

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