SetupDiInstallClassW-Funktion (setupapi.h)
Die SetupDiInstallClass-Funktion installiert den Abschnitt ClassInstall32 der angegebenen INF-Datei.
Syntax
WINSETUPAPI BOOL SetupDiInstallClassW(
[in, optional] HWND hwndParent,
[in] PCWSTR InfFileName,
[in] DWORD Flags,
[in, optional] HSPFILEQ FileQueue
);
Parameter
[in, optional] hwndParent
Das Handle zum übergeordneten Fenster für jede Benutzeroberfläche, die zum Installieren dieser Klasse verwendet wird. Dieser Parameter ist optional und kann NULL sein.
[in] InfFileName
Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen der INF-Datei enthält, die einen INF ClassInstall32-Abschnitt enthält.
[in] Flags
Diese Flags steuern den Installationsprozess. Kann eine Kombination aus folgenden Komponenten sein:
DI_NOVCP
Legen Sie dieses Flag fest, wenn FileQueue angegeben wird. DI_NOVCP weist die Funktion SetupInstallFromInfSection (in Microsoft Windows SDK Dokumentation beschrieben) an, keine eigene Warteschlange zu erstellen und stattdessen die vom Aufrufer bereitgestellte Warteschlange zu verwenden. Wenn dieses Flag festgelegt ist, werden Dateien nicht nur in die Warteschlange kopiert.
DI_NOBROWSE
Legen Sie dieses Flag fest, um das Durchsuchen zu deaktivieren, wenn ein Kopiervorgang eine angegebene Datei nicht finden kann. Wenn der Aufrufer eine Dateiwarteschlange bereitstellt, wird dieses Flag ignoriert.
DI_FORCECOPY
Legen Sie dieses Flag so fest, dass Dateien immer kopiert werden, auch wenn sie bereits auf dem Computer des Benutzers vorhanden sind. Wenn der Aufrufer eine Dateiwarteschlange bereitstellt, wird dieses Flag ignoriert.
DI_QUIETINSTALL
Legen Sie dieses Flag fest, um die Benutzeroberfläche zu unterdrücken, sofern dies nicht unbedingt erforderlich ist. Zeigen Sie z. B. das Statusdialogfeld nicht an. Wenn der Aufrufer eine Dateiwarteschlange bereitstellt, wird dieses Flag ignoriert.
[in, optional] FileQueue
Wenn das flag DI_NOVCP festgelegt ist, stellt dieser Parameter ein Handle für eine Dateiwarteschlange bereit, in der Dateivorgänge in eine Warteschlange eingereiht, aber nicht committet werden sollen.
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 dieser Funktion muss Mitglied der Gruppe Administratoren sein.
Diese Funktion wird von einem Klasseninstallationsprogramm aufgerufen, wenn ein Gerät einer neuen Geräteklasse installiert wird.
Verwenden Sie SetupDiInstallClassEx, um eine Schnittstellen- oder Geräteklasse zu installieren.
Hinweis
Der setupapi.h-Header definiert SetupDiInstallClass als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
Zielplattform | Desktop |
Kopfzeile | setupapi.h (einschließlich Setupapi.h) |
Bibliothek | Setupapi.lib |