SetupDiGetClassImageListExA-Funktion (setupapi.h)

Die SetupDiGetClassImageListEx-Funktion erstellt eine Bildliste mit Bitmaps für jede Klasse, die auf einem lokalen oder Remotesystem installiert ist.

Syntax

WINSETUPAPI BOOL SetupDiGetClassImageListExA(
  [out]          PSP_CLASSIMAGELIST_DATA ClassImageListData,
  [in, optional] PCSTR                   MachineName,
                 PVOID                   Reserved
);

Parameter

[out] ClassImageListData

Ein Zeiger auf eine SP_CLASSIMAGELIST_DATA Struktur zum Empfangen von Informationen zur Klassenbildliste, einschließlich eines Handles für die Bildliste. Das cbSize-Feld dieser Struktur muss mit der Größe der Struktur in Bytes initialisiert werden, bevor diese Funktion aufgerufen wird. Andernfalls tritt ein Fehler auf.

[in, optional] MachineName

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen eines Remotesystems bereitstellt, für dessen Klassen SetupDiGetClassImageListEx die Bitmap erstellen muss . Dieser Parameter ist optional und kann NULL sein. Wenn MachineNameNULL ist, erstellt SetupDiGetClassImageListEx die Liste für das lokale System.

Achtung

Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.

Reserved

Muss NULL sein.

Rückgabewert

Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann durch einen Aufruf von GetLastError abgerufen werden.

Hinweise

Die von dieser Funktion erstellte Imageliste sollte durch Aufrufen von SetupDiDestroyClassImageList zerstört werden.

Hinweis Klassenspezifische Symbole auf einem Remotecomputer können nur angezeigt werden, wenn die Klasse auch auf dem lokalen Computer vorhanden ist. Wenn der Remotecomputer also die Klasse X aufweist, klasse X jedoch nicht lokal installiert ist, wird das generische Symbol (unbekannt) zurückgegeben.

 

Hinweis

Der Setupapi.h-Header definiert SetupDiGetClassImageListEx 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
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	setupapi.h (schließen Sie Setupapi.h ein)
Bibliothek	Setupapi.lib

Weitere Informationen

SetupDiDestroyClassImageList

SetupDiGetClassImageList