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
指向包含 INF 文件名称的以 NULL 结尾的字符串的指针。 此参数是可选的,可以为 NULL。 如果此函数用于安装类安装程序,INF 文件包含 INF ClassInstall32 节 ,此参数不得为 NULL。
如果使用此函数安装接口类,INF 文件将包含 INF InterfaceInstall32 节。
[in] Flags
控制安装过程的 DWORD 类型的值。 标志 可以是零或按位或以下值的 OR:
DI_NOVCP
如果提供了 FileQueue, 请设置此标志。
DI_NOVCP指示 SetupInstallFromInfSection 函数不要创建自己的队列,而是改用调用方提供的队列。
如果设置了此标志,则不会复制文件只是排队。
有关 SetupInstallFromInfSection 函数的详细信息,请参阅Microsoft Windows SDK文档。
DI_NOBROWSE
设置此标志以在复制操作找不到指定文件时禁用浏览。 如果调用方提供文件队列,则忽略此标志。
DI_FORCECOPY
将此标志设置为始终复制文件,即使文件已存在于用户的计算机上。 如果调用方提供文件队列,则忽略此标志。
DI_QUIETINSTALL
设置此标志以禁止显示用户界面,除非绝对必要。 例如,不显示进度对话框。 如果调用方提供文件队列,则忽略此标志。
[in, optional] FileQueue
如果设置了DI_NOVCP标志,此参数将为文件队列提供一个句柄,文件操作应排队但不提交。
[in, optional] InterfaceClassGuid
指向标识要安装的接口类的 GUID 的指针。 此参数是可选的,可以为 NULL。 如果指定此参数,则此函数将用于安装 GUID 表示的接口类。 如果此参数为 NULL,则使用此函数安装类安装程序。
Reserved1
保留。 必须为零。
Reserved2
保留。 必须为零。
返回值
如果成功,SetupDiInstallClassEx 将返回 TRUE 。 否则,它将返回 FALSE ,并且可以通过调用 GetLastError 来检索记录的错误。
注解
此函数的调用方必须是管理员组的成员。
SetupDiInstallClassEx 通常由类安装程序调用,以安装新的 设备安装类 或新的 设备接口类。
注意
setupapi.h 标头将 SetupDiInstallClassEx 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
最低受支持的客户端 | 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。 |
目标平台 | 桌面 |
标头 | setupapi.h (包括 Setupapi.h) |
Library | Setupapi.lib |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈