SetupDiInstallClassExA-Funktion (setupapi.h)
Die SetupDiInstallClassEx Funktion installiert ein Klasseninstallationsprogramm oder eine Schnittstellenklasse.
Syntax
WINSETUPAPI BOOL SetupDiInstallClassExA(
[in, optional] HWND hwndParent,
[in, optional] PCSTR InfFileName,
[in] DWORD Flags,
[in, optional] HSPFILEQ FileQueue,
[in, optional] const GUID *InterfaceClassGuid,
PVOID Reserved1,
PVOID Reserved2
);
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, optional] InfFileName
Ein Zeiger auf eine MIT NULL beendete Zeichenfolge, die den Namen einer INF-Datei enthält. Dieser Parameter ist optional und kann NULL-werden. Wenn diese Funktion zum Installieren eines Klasseninstallationsprogramms verwendet wird, enthält die INF-Datei einen INF ClassInstall32-Abschnitt und dieser Parameter darf nicht NULL-sein.
Wenn diese Funktion zum Installieren einer Schnittstellenklasse verwendet wird, enthält die INF-Datei einen INF InterfaceInstall32-Abschnitt.
[in] Flags
Ein Wert vom Typ DWORD, der den Installationsprozess steuert. Flags können null oder ein bitweiser ODER der folgenden Werte sein:
DI_NOVCP
Legen Sie dieses Kennzeichen fest, wenn FileQueue- angegeben wird.
DI_NOVCP weist die SetupInstallFromInfSection Funktion an, keine 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.
Weitere Informationen zur funktion SetupInstallFromInfSection finden Sie in der Microsoft Windows SDK-Dokumentation.
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.
[in, optional] InterfaceClassGuid
Ein Zeiger auf eine GUID, die die zu installierende Schnittstellenklasse identifiziert. Dieser Parameter ist optional und kann NULL-werden. Wenn dieser Parameter angegeben ist, wird diese Funktion verwendet, um die durch die GUID dargestellte Schnittstellenklasse zu installieren. Wenn dieser Parameter NULL-ist, wird diese Funktion verwendet, um ein Klasseninstallationsprogramm zu installieren.
Reserved1
Reserviert. Muss null sein.
Reserved2
Reserviert. Muss null sein.
Rückgabewert
SetupDiInstallClassEx gibt TRUE- zurück, wenn dies 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.
SetupDiInstallClassEx- wird in der Regel von einem Klasseninstallationsprogramm aufgerufen, um eine neue Gerätesetupklasse oder eine neue Geräteschnittstellenklassezu installieren.
Anmerkung
Der Header setupapi.h definiert SetupDiInstallClassEx 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 |