Функция SetupDiInstallClassW (setupapi.h)
Функция SetupDiInstallClass устанавливает раздел ClassInstall32 указанного INF-файла.
Синтаксис
WINSETUPAPI BOOL SetupDiInstallClassW(
[in, optional] HWND hwndParent,
[in] PCWSTR InfFileName,
[in] DWORD Flags,
[in, optional] HSPFILEQ FileQueue
);
Параметры
[in, optional] hwndParent
Дескриптор родительского окна для любого пользовательского интерфейса, используемого для установки этого класса. Этот параметр является необязательным и может быть null.
[in] InfFileName
Указатель на строку, завершающую значение NULL, которая содержит имя INF-файла, содержащего раздел INF ClassInstall32.
[in] Flags
Эти флаги управляют процессом установки. Может быть сочетанием следующих значений:
DI_NOVCP
Установите этот флаг, если указан FileQueue. DI_NOVCP указывает функцию SetupInstallFromInfSection (описанную в документации по пакету SDK Для Microsoft Windows) не создавать очередь собственной и использовать очередь, предоставляемую вызывающим поставщиком. Если этот флаг задан, файлы не копируются только в очереди.
DI_NOBROWSE
Установите этот флаг, чтобы отключить просмотр, если операция копирования не может найти указанный файл. Если вызывающий объект предоставляет очередь файлов, этот флаг игнорируется.
DI_FORCECOPY
Установите этот флаг для всегдаго копирования файлов, даже если они уже присутствуют на компьютере пользователя. Если вызывающий объект предоставляет очередь файлов, этот флаг игнорируется.
DI_QUIETINSTALL
Установите этот флаг, чтобы отключить пользовательский интерфейс, если это не обязательно. Например, не отображайте диалоговое окно хода выполнения. Если вызывающий объект предоставляет очередь файлов, этот флаг игнорируется.
[in, optional] FileQueue
Если установлен флаг DI_NOVCP, этот параметр предоставляет дескриптор в очередь файлов, в которой операции с файлами должны быть помещены в очередь, но не зафиксированы.
Возвращаемое значение
Функция возвращает TRUE, если она выполнена успешно. В противном случае возвращается FALSE, а ошибка журнала может быть получена с помощью вызова GetLastError.
Замечания
Вызывающий объект этой функции должен быть членом группы "Администраторы".
Эта функция вызывается установщиком классов при установке устройства нового класса.
Чтобы установить класс интерфейса или класс устройства, используйте SetupDiInstallClassEx.
Заметка
Заголовок setupapi.h определяет SetupDiInstallClass как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| целевая платформа | Настольный |
| заголовка | setupapi.h (include Setupapi.h) |
| библиотеки |
Setupapi.lib |