通过

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来检索记录的错误。

言论

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

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

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

注意

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

要求

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

另请参阅

SetupDiCallClassInstaller

SetupDiInstallDeviceInterfaces