Fonction SetupDiGetClassImageListExA (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

Un pointeur vers une structure de SP_CLASSIMAGELIST_DATA pour recevoir des informations concernant la liste d’images de classe, y compris un handle vers la liste d’images. Le champ cbSize de cette structure doit être initialisé avec la taille de la structure, en octets, avant d’appeler cette fonction, sinon elle échoue.

[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 a la valeur NULL, SetupDiGetClassImageListEx génère la liste pour le système local.

Attention

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 avoir la valeur NULL.

Valeur retournée

La fonction retourne TRUE si elle réussit. Sinon, il retourne FALSE 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.

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

 

Notes

L’en-tête setupapi.h définit SetupDiGetClassImageListEx comme un 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	setupapi.h (inclure Setupapi.h)
Bibliothèque	Setupapi.lib

Voir aussi

SetupDiDestroyClassImageList

SetupDiGetClassImageList