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