SetupDiInstallClassA-Funktion (setupapi.h)
Die SetupDiInstallClass-Funktion installiert den ClassInstall32 Abschnitt der angegebenen INF-Datei.
Syntax
WINSETUPAPI BOOL SetupDiInstallClassA(
[in, optional] HWND hwndParent,
[in] PCSTR InfFileName,
[in] DWORD Flags,
[in, optional] HSPFILEQ FileQueue
);
Parameter
[in, optional] hwndParent
Das Handle für das übergeordnete Fenster für jede Benutzeroberfläche, die zum Installieren dieser Klasse verwendet wird. Dieser Parameter ist optional und kann NULL-werden.
[in] InfFileName
Ein Zeiger auf eine MIT NULL beendete Zeichenfolge, die den Namen der INF-Datei enthält, die einen INF ClassInstall32-Abschnittenthält.
[in] Flags
Diese Flags steuern den Installationsprozess. Dies kann eine Kombination aus folgendem Sein:
DI_NOVCP
Legen Sie dieses Kennzeichen fest, wenn FileQueue- angegeben wird. DI_NOVCP weist die funktion SetupInstallFromInfSection (in der Microsoft Windows SDK-Dokumentation beschrieben) nicht an, eine eigene Warteschlange zu erstellen und stattdessen die vom Aufrufer bereitgestellte Warteschlange zu verwenden. Wenn dieses Kennzeichen festgelegt ist, werden Dateien nicht nur in die Warteschlange kopiert.
DI_NOBROWSE
Legen Sie dieses Kennzeichen fest, um das Browsen 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 Kennzeichen 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 Kennzeichen fest, um die Benutzeroberfläche zu unterdrücken, es sei denn, es ist unbedingt erforderlich. Zeigen Sie z. B. das Statusdialogfeld nicht an. Wenn der Aufrufer eine Dateiwarteschlange bereitstellt, wird dieses Flag ignoriert.
[in, optional] FileQueue
Wenn das DI_NOVCP Flag festgelegt ist, stellt dieser Parameter ein Handle für eine Dateiwarteschlange bereit, bei der Dateivorgänge in die Warteschlange gestellt werden sollen, aber nicht zugesichert 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 GetLastErrorabgerufen werden.
Bemerkungen
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 Schnittstellenklasse oder eine Geräteklasse zu installieren.
Anmerkung
Der Header setupapi.h definiert SetupDiInstallClass als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | setupapi.h (include Setupapi.h) |
| Library | Setupapi.lib |