通过

SetupDiInstallClassA 函数 （setupapi.h）

  • 项目

SetupDiInstallClass 函数安装指定的 INF 文件的 ClassInstall32 节。

语法

WINSETUPAPI BOOL SetupDiInstallClassA(
  [in, optional] HWND     hwndParent,
  [in]           PCSTR    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 函数（Microsoft Windows SDK 文档中所述）不要创建自己的队列并使用调用方提供的队列。 如果设置了此标志，则不会仅对文件进行排队复制。

DI_NOBROWSE

如果复制操作找不到指定文件，请设置此标志以禁用浏览。 如果调用方提供文件队列，则忽略此标志。

DI_FORCECOPY

将此标志设置为始终复制文件，即使这些文件已存在于用户的计算机上也是如此。 如果调用方提供文件队列，则忽略此标志。

DI_QUIETINSTALL

将此标志设置为禁止显示用户界面，除非绝对必要。 例如，不显示进度对话框。 如果调用方提供文件队列，则忽略此标志。

[in, optional] FileQueue

如果设置了DI_NOVCP标志，此参数将为文件队列提供句柄，其中应对文件操作进行排队但未提交。

返回值

如果函数成功，则返回 TRUE。 否则，它会返回 FALSE，可以通过调用 getLastError来检索记录的错误。

言论

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

此函数由类安装程序在安装新设备类的设备时调用。

若要安装接口类或设备类，请使用 SetupDiInstallClassEx。

注意

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

要求

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

另请参阅

SetupDiCallClassInstaller

SetupDiInstallClassEx