SetupDiRegisterCoDeviceInstallers 函数 (setupapi.h)

  • 项目

SetupDiRegisterCoDeviceInstallers 函数是DIF_REGISTER_COINSTALLERS的默认处理程序。

语法

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

参数

[in] DeviceInfoSet

设备信息集的句柄，其中包含表示要为其注册共同安装程序的设备的设备信息元素。 设备信息集不得包含任何远程元素。

[in] DeviceInfoData

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

返回值

如果函数成功，SetupDiRegisterCoDeviceInstallers 将返回 TRUE。 如果函数返回 FALSE，请调用 GetLastError 以获取扩展错误信息。

注解

SetupDiRegisterCoDeviceInstallers 的调用方必须是 Administrators 组的成员。

注意 只有类安装程序应调用 SetupDiRegisterCoDeviceInstallers ，并且仅在类安装程序必须在 SetupDiRegisterCoDeviceInstallers 完成默认共同安装程序注册操作后执行共同安装程序注册操作的情况下调用。 在这种情况下，当安装程序处理DIF_REGISTER_COINSTALLERS请求时，类安装程序必须直接调用 SetupDiRegisterCoDeviceInstallers 。 有关调用默认处理程序的详细信息，请参阅 调用默认 DIF 代码处理程序。
 
SetupDiRegisterCoDeviceInstallers 读取 DeviceInfoData 指定的设备的 INF 文件，并创建注册表项以注册 INF 文件中列出的任何特定于设备的共同安装程序。 INF DDInstall.CoInstallers 部分中列出了共同安装程序。 除非设置了 DI_NOFILECOPY 标志，否则此函数还会复制共同安装程序的文件。

如果未选择驱动程序，或者设备具有适用于 Windows 9x 或 Millennium Edition 的 INF 文件，则此函数不会注册任何共同安装程序。

注册特定于设备的新共同安装程序会使设备安装程序的当前共同安装程序列表失效。 成功注册后，设备安装程序会更新其共同安装程序列表。

此函数仅注册特定于设备的共同安装程序，而不注册类共同安装程序。

有关如何编写和注册特定于设备的共同安装程序的详细信息，请参阅 编写共同安装程序。

DeviceInfoSet 指定的设备信息集只能包含本地计算机上的元素。

要求

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

另请参阅

DIF_REGISTER_COINSTALLERS

SetupDiCallClassInstaller