SetupDiInstallClassA-Funktion (setupapi.h)

  • Artikel

Die SetupDiInstallClass-Funktion installiert den Abschnitt ClassInstall32 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 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

Weitere Informationen

SetupDiCallClassInstaller

SetupDiInstallClassEx