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

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

Синтаксис

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

Параметры

[in] DeviceInfoSet

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

[in] DeviceInfoData

Указатель на структуру SP_DEVINFO_DATA , указывающую элемент сведений об устройстве в DeviceInfoSet.

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

SetupDiRegisterCoDeviceInstallers возвращает значение TRUE , если функция завершается успешно. Если функция возвращает значение FALSE, вызовите Метод GetLastError для получения дополнительных сведений об ошибке.

Комментарии

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

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

 

SetupDiRegisterCoDeviceInstallers считывает INF-файл для устройства, указанного в DeviceInfoData , и создает записи реестра для регистрации всех соустановок для конкретного устройства, перечисленных в INF-файле. Совместные установщики перечислены в разделе INF DDInstall.CoInstallers. Эта функция также копирует файлы для совместных установщиков, если не установлен флаг DI_NOFILECOPY.

Если драйвер не выбран или устройство имеет INF-файл для Windows 9x или Millennium Edition, эта функция не регистрирует со-установщики.

Регистрация нового совместного установщика для конкретного устройства делает недействительным текущий список установщиков устройств. После успешной регистрации установщик устройства обновит список совместных установщиков.

Эта функция регистрирует только совместные установщики для конкретного устройства, но не соазначаемые установщики класса.

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

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

Требования

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

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

DIF_REGISTER_COINSTALLERS

SetupDiCallClassInstaller