setupDiInstallDriverFiles 函数 (setupapi.h)

  • 项目

SetupDiInstallDriverFiles 函数是DIF_INSTALLDEVICEFILES安装请求的默认处理程序。

语法

WINSETUPAPI BOOL SetupDiInstallDriverFiles(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

参数

[in] DeviceInfoSet

设备信息集的句柄，其中包含表示要为其安装文件的设备的设备信息元素。 设备信息集不得包含远程元素。

[in] DeviceInfoData

指向 SP_DEVINFO_DATA 结构的指针，该结构指定 DeviceInfoSet 中的设备信息元素。

返回值

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

注解

如果使用此函数安装文件， 则 SetupDiInstallDriverFiles 的调用方必须是 Administrators 组的成员。 但是，如果使用此函数来构建文件队列，则不需要 Administrators 组中的成员身份。

注意 只有类安装程序应调用 SetupDiInstallDriverFiles ，并且仅在类安装程序必须在 SetupDiInstallDriverFiles 完成默认驱动程序文件安装操作后执行驱动程序文件安装操作的情况下调用。 在这种情况下，当安装程序处理DIF_INSTALLDEVICEFILES请求时，类安装程序必须直接调用 SetupDiInstallDriverFiles 。 有关调用默认处理程序的详细信息，请参阅 调用默认 DIF 代码处理程序。
 
SetupDiInstallDriverFiles 的操作类似于 SetupDiInstallDevice 函数。 但是，此函数仅执行 SetupDiInstallDevice 执行的文件复制操作。

在调用此函数之前，必须为指定的设备信息集或元素选择驱动程序。

此函数处理所选 INF 文件中的 CopyFiles、 Delfiles 和 Renfiles 条目。

DeviceInfoSet 只能包含本地计算机上的元素。

要求

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

另请参阅

SetupDiCallClassInstaller

SetupDiInstallDevice