SetupDiInstallDriverFiles function (setupapi.h)
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.
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 |