nf-setupapi-setupdiregistercodeviceinstallers.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:setupapi.SetupDiRegisterCoDeviceInstallers	SetupDiRegisterCoDeviceInstallers function (setupapi.h)	The SetupDiRegisterCoDeviceInstallers function is the default handler for DIF_REGISTER_COINSTALLERS.	SetupDiRegisterCoDeviceInstallers SetupDiRegisterCoDeviceInstallers function [Device and Driver Installation] devinst.setupdiregistercodeviceinstallers di-rtns_03f0dc0a-f133-4280-b32d-9a811d04a844.xml setupapi/SetupDiRegisterCoDeviceInstallers	devinst\setupdiregistercodeviceinstallers.htm	devinst	75d0275b-9eb8-45ec-ac8e-b18d59e0c011	12/05/2018	SetupDiRegisterCoDeviceInstallers, SetupDiRegisterCoDeviceInstallers function [Device and Driver Installation], devinst.setupdiregistercodeviceinstallers, di-rtns_03f0dc0a-f133-4280-b32d-9a811d04a844.xml, setupapi/SetupDiRegisterCoDeviceInstallers	setupapi.h	Setupapi.h	Desktop	Available in Microsoft Windows 2000 and later versions of Windows.											Setupapi.lib	Setupapi.dll		Windows			19H1	SetupDiRegisterCoDeviceInstallers setupapi/SetupDiRegisterCoDeviceInstallers	c++	APIRef kbSyntax	DllExport	Setupapi.dll	SetupDiRegisterCoDeviceInstallers

SetupDiRegisterCoDeviceInstallers function

-description

The SetupDiRegisterCoDeviceInstallers function is the default handler for DIF_REGISTER_COINSTALLERS.

-parameters

-param DeviceInfoSet [in]

A handle to the device information set that contains a device information element that represents the device for which to register co-installers. The device information set must not contain any remote elements.

-param DeviceInfoData [in]

A pointer to an SP_DEVINFO_DATA structure that specifies the device information element in DeviceInfoSet.

-returns

SetupDiRegisterCoDeviceInstallers returns TRUE if the function succeeds. If the function returns FALSE, call GetLastError for extended error information.

-remarks

The caller of SetupDiRegisterCoDeviceInstallers must be a member of the Administrators group.

Note  Only a class installer should call SetupDiRegisterCoDeviceInstallers and only in those situations where the class installer must perform co-installer registration operations after SetupDiRegisterCoDeviceInstallers completes the default co-installer registration operation. In such situations, the class installer must directly call SetupDiRegisterCoDeviceInstallers when the installer processes a DIF_REGISTER_COINSTALLERS request. For more information about calling the default handler, see Calling Default DIF Code Handlers.

 

SetupDiRegisterCoDeviceInstallers reads the INF file for the device specified by DeviceInfoData and creates registry entries to register any device-specific co-installers listed in the INF file. Co-installers are listed in an INF DDInstall.CoInstallers section. This function also copies the files for the co-installers, unless the DI_NOFILECOPY flag is set.

If there is no driver selected, or the device has an INF file for Windows 9x or Millennium Edition, this function does not register any co-installers.

Registering a new device-specific co-installer invalidates the Device Installer's current list of co-installers. After a successful registration, the Device Installer updates its list of co-installers.

This function only registers device-specific co-installers, not class co-installers.

For more information about how to write and register device-specific co-installers, see Writing a Co-installer.

The device information set specified by DeviceInfoSet must only contain elements on the local computer.

-see-also

DIF_REGISTER_COINSTALLERS

SetupDiCallClassInstaller