setupDiInstallClassExA 函数 (setupapi.h)

项目
08/26/2023

SetupDiInstallClassEx 函数安装类安装程序或接口类。

语法

WINSETUPAPI BOOL SetupDiInstallClassExA(
  [in, optional] HWND       hwndParent,
  [in, optional] PCSTR      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 节，并且此参数不得为 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 的指针，该 GUID 标识要安装的接口类。此参数是可选的，可以为 NULL。如果指定此参数，则此函数将用于安装由 GUID 表示的接口类。如果此参数为 NULL，则此函数用于安装类安装程序。

Reserved1

保留。必须为零。

Reserved2

保留。必须为零。

返回值

SetupDiInstallClassEx 如果成功，则返回 TRUE 。否则，它将返回 FALSE ，并且可以通过调用 GetLastError 来检索记录的错误。

注解

此函数的调用方必须是 Administrators 组的成员。

SetupDiInstallClassEx 通常由类安装程序调用，以安装新的设备安装程序类或新的设备接口类。

注意还可以通过调用 SetupDiInstallDeviceInterfaces 来为设备安装设备接口来自动安装接口类。

注意

setupapi.h 标头将 SetupDiInstallClassEx 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

要求	值
最低受支持的客户端	在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台	桌面
标头	setupapi.h (包括 Setupapi.h)
Library	Setupapi.lib

另请参阅

SetupDiCallClassInstaller

SetupDiInstallDeviceInterfaces