SetupDiInstallClassExW-Funktion (setupapi.h)

Die SetupDiInstallClassEx-Funktion installiert ein Klasseninstallationsprogramm oder eine Schnittstellenklasse.

Syntax

WINSETUPAPI BOOL SetupDiInstallClassExW(
  [in, optional] HWND       hwndParent,
  [in, optional] PCWSTR     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 Eine Schnittstellenklasse kann auch automatisch installiert werden, indem SetupDiInstallDeviceInterfaces aufgerufen wird, um die Geräteschnittstellen für ein Gerät 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

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

Weitere Informationen

SetupDiCallClassInstaller

SetupDiInstallDeviceInterfaces