SetupDiInstallDriverFiles-Funktion (setupapi.h)

Die SetupDiInstallDriverFiles-Funktion ist der Standardhandler für die DIF_INSTALLDEVICEFILES Installationsanforderung.

Syntax

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

Parameter

[in] DeviceInfoSet

Ein Handle für den Geräteinformationssatz , der das Geräteinformationselement enthält, das das Gerät darstellt, für das Dateien installiert werden sollen. Der Geräteinformationssatz darf keine Remoteelemente enthalten.

[in] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die das Geräteinformationselement in DeviceInfoSet angibt.

Rückgabewert

Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann mit einem Aufruf von GetLastError abgerufen werden.

Hinweise

Der Aufrufer von SetupDiInstallDriverFiles muss Mitglied der Gruppe Administratoren sein, wenn diese Funktion zum Installieren von Dateien verwendet wird. Wenn diese Funktion jedoch zum Erstellen einer Dateiwarteschlange verwendet wird, ist die Mitgliedschaft in der Gruppe Administratoren nicht erforderlich.

Hinweis Nur ein Klasseninstallationsprogramm sollte SetupDiInstallDriverFiles aufrufen, und zwar nur in situationen, in denen das Klasseninstallationsprogramm Treiberdateiinstallationsvorgänge ausführen muss, nachdem SetupDiInstallDriverFiles den Standardinstallationsvorgang der Treiberdatei abgeschlossen hat. In solchen Situationen muss das Klasseninstallationsprogramm SetupDiInstallDriverFiles direkt aufrufen, wenn das Installationsprogramm eine DIF_INSTALLDEVICEFILES-Anforderung verarbeitet. Weitere Informationen zum Aufrufen des Standardhandlers finden Sie unter Aufrufen von DIF-Standardcodehandlern.

 

Der Vorgang von SetupDiInstallDriverFiles ähnelt der SetupDiInstallDevice-Funktion . Diese Funktion führt jedoch nur die Dateikopiervorgänge aus, die von SetupDiInstallDevice ausgeführt werden.

Ein Treiber muss für den angegebenen Geräteinformationssatz oder das angegebene Element ausgewählt werden, bevor diese Funktion aufgerufen wird.

Diese Funktion verarbeitet die Einträge CopyFiles, Delfiles und Renfiles in der ausgewählten INF-Datei.

DeviceInfoSet darf nur Elemente auf dem lokalen Computer enthalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	setupapi.h (schließen Sie Setupapi.h ein)
Bibliothek	Setupapi.lib
DLL	Setupapi.dll

Weitere Informationen

SetupDiCallClassInstaller

SetupDiInstallDevice