SetupDiGetClassImageListExA-Funktion (setupapi.h)

Die SetupDiGetClassImageListEx--Funktion erstellt eine Bildliste von 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, um Informationen zur Klassenbildliste zu erhalten, einschließlich eines Handles zur Bildliste. Das cbSize Feld dieser Struktur muss mit der Größe der Struktur in Byte initialisiert werden, bevor diese Funktion aufgerufen wird oder ein Fehler auftritt.

[in, optional] MachineName

Ein Zeiger auf NULL beendete Zeichenfolge, die den Namen eines Remotesystems bereitstellt, für dessen Klassen SetupDiGetClassImageListEx der Bitmap erstellen müssen. Dieser Parameter ist optional und kann NULL-werden. Wenn MachineName-NULL-ist, erstellt SetupDiGetClassImageListEx die Liste für das lokale System.

Vorsicht

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 GetLastErrorabgerufen werden.

Bemerkungen

Die von dieser Funktion erstellte Bildliste sollte durch Aufrufen SetupDiDestroyClassImageListzerstört werden.

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

 

Anmerkung

Der Header setupapi.h 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
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

Siehe auch

SetupDiDestroyClassImageList

SetupDiGetClassImageList-