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 zum übergeordneten Fenster für jede Benutzeroberfläche, die zum Installieren dieser Klasse verwendet wird. Dieser Parameter ist optional und kann NULL sein.
[in, optional] InfFileName
Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen einer INF-Datei enthält. Dieser Parameter ist optional und kann NULL sein. Wenn diese Funktion zum Installieren eines Klasseninstallationsprogramms verwendet wird, enthält die INF-Datei einen Abschnitt INF ClassInstall32 , und dieser Parameter darf nicht NULL sein.
Wenn diese Funktion zum Installieren einer Schnittstellenklasse verwendet wird, enthält die INF-Datei den Abschnitt INF InterfaceInstall32.
[in] Flags
Ein Wert vom Typ DWORD, der den Installationsprozess steuert. Flags können null oder bitweise OR der folgenden Werte sein:
DI_NOVCP
Legen Sie dieses Flag 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 Flag 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 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.
[in, optional] InterfaceClassGuid
Ein Zeiger auf eine GUID, die die zu installierende Schnittstellenklasse identifiziert. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter angegeben wird, wird diese Funktion verwendet, um die von der GUID dargestellte Schnittstellenklasse zu installieren. Wenn dieser Parameter NULL ist, wird diese Funktion zum Installieren eines Klasseninstallationsprogramms verwendet.
Reserved1
Reserviert. Muss Null sein.
Reserved2
Reserviert. Muss Null sein.
Rückgabewert
SetupDiInstallClassEx gibt TRUE zurück, wenn es 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.
SetupDiInstallClassEx wird in der Regel von einem Klasseninstallationsprogramm aufgerufen, um eine neue Gerätesetupklasse oder eine neue Geräteschnittstellenklasse zu installieren.
Hinweis
Der setupapi.h-Header definiert SetupDiInstallClassEx 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 |