SetupDiGetClassImageListExA, fonction (setupapi.h)

La fonction SetupDiGetClassImageListEx génère une liste d’images bitmap pour chaque classe installée sur un système local ou distant.

Syntaxe

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

Paramètres

[out] ClassImageListData

Pointeur vers une structure SP_CLASSIMAGELIST_DATA pour recevoir des informations concernant la liste d’images de classe, y compris un handle vers la liste d’images. La cbSize champ de cette structure doit être initialisée avec la taille de la structure, en octets, avant d’appeler cette fonction ou elle échouera.

[in, optional] MachineName

Pointeur vers une chaîne terminée par NULL qui fournit le nom d’un système distant pour lequel les classes SetupDiGetClassImageListEx doivent générer l’image bitmap. Ce paramètre est facultatif et peut être NULL. Si MachineName est NULL, SetupDiGetClassImageListEx génère la liste du système local.

Prudence

L’utilisation de cette fonction pour accéder aux machines distantes n’est pas prise en charge à partir de Windows 8 et Windows Server 2012, car cette fonctionnalité a été supprimée.

Reserved

Doit être NULL .

Valeur de retour

La fonction retourne TRUE si elle réussit. Sinon, elle retourne faux et l’erreur journalisée peut être récupérée par un appel à GetLastError.

Remarques

La liste d’images générée par cette fonction doit être détruite en appelant SetupDiDestroyClassImageList.

Remarque icônes spécifiques à la classe sur un ordinateur distant ne peut être affichée que si la classe est également présente sur l’ordinateur local. Par conséquent, si l’ordinateur distant a une classe X, mais que la classe X n’est pas installée localement, l’icône générique (inconnue) est retournée.

 

Note

L’en-tête setupapi.h définit SetupDiGetClassImageListEx comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
plateforme cible	Bureau
d’en-tête	setupapi.h (include Setupapi.h)
bibliothèque	Setupapi.lib

Voir aussi

SetupDiDestroyClassImageList

SetupDiGetClassImageList