SetupDiInstallClassA 函数 (setupapi.h)

项目
08/26/2023

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 ClassInstall32 节的 INF 文件的名称。

[in] Flags

这些标志控制安装过程。可以是以下各项的组合：

DI_NOVCP

如果提供了 FileQueue， 请设置此标志。 DI_NOVCP指示Microsoft Windows SDK文档中介绍的 SetupInstallFromInfSection 函数 (，) 不要创建自己的队列，而是使用调用方提供的队列。如果设置了此标志，则不会复制文件只是排队。

DI_NOBROWSE

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

DI_FORCECOPY

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

DI_QUIETINSTALL

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

[in, optional] FileQueue

如果设置了DI_NOVCP标志，此参数将为文件队列提供一个句柄，文件操作应排队但不提交。

返回值

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

注解

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

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

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

注意

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

要求

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

另请参阅

SetupDiCallClassInstaller

SetupDiInstallClassEx

通过