SetupDiInstallDriverFiles function (setupapi.h)

Article
10/13/2021

The SetupDiInstallDriverFiles function is the default handler for the DIF_INSTALLDEVICEFILES installation request.

Syntax

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

Parameters

[in] DeviceInfoSet

A handle to the device information set that contains the device information element that represents the device for which to install files. The device information set must not contain remote elements.

[in] DeviceInfoData

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

Return value

The function returns TRUE if it is successful. Otherwise, it returns FALSE and the logged error can be retrieved with a call to GetLastError.

Remarks

The caller of SetupDiInstallDriverFiles must be a member of the Administrators group if this function is being used to install files. However, if this function is being used to build up a file queue, membership in the Administrators group is not required.

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

The operation of SetupDiInstallDriverFiles is similar to the SetupDiInstallDevice function. However, this function performs only the file copy operations that are performed by SetupDiInstallDevice.

A driver must be selected for the specified device information set or element before this function is called.

This function processes the CopyFiles, Delfiles, and Renfiles entries in the selected INF file.

The DeviceInfoSet must only contain elements on the local computer.

Requirements

Requirement	Value
Minimum supported client	Available in Microsoft Windows 2000 and later versions of Windows.
Target Platform	Desktop
Header	setupapi.h (include Setupapi.h)
Library	Setupapi.lib
DLL	Setupapi.dll