ImageList_CoCreateInstance, fonction (commoncontrols.h)

Article
08/22/2023

Crée une instance unique d’une liste d’images et retourne un pointeur d’interface vers celle-ci.

Syntaxe

HRESULT ImageList_CoCreateInstance(
  [in]           REFCLSID       rclsid,
  [in, optional] const IUnknown *punkOuter,
  [in]           REFIID         riid,
  [out]          void           **ppv
);

Paramètres

[in] rclsid

Type : REFCLSID

Référence au CLSID, guid qui identifie l’objet COM à créer. Cela doit être CLSID_ImageList.

[in, optional] punkOuter

Type : const IUnknown*

Pointeur vers l’interface IUnknown externe qui agrège l’objet créé par cette fonction, ou NULL si aucune agrégation n’est souhaitée.

[in] riid

Type : REFIID

Référence à l’ID d’interface souhaité.

[out] ppv

Type : void**

Lorsque cette méthode est retournée, contient le pointeur d’interface demandé dans riid. Il s’agit normalement de IImageList2, qui fournit la méthode Initialize .

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Avant d’appeler cette fonction, COM doit être initialisé en appelant CoInitialize ou CoInitializeEx.

Appelez ImageList_CoCreateInstance pour obtenir une liste d’images personnalisée ; sinon, appelez SHGetImageList pour charger la liste d’images système. Appelez SHGetFileInfo avec le paramètre uflag défini sur SHGFI_SYSICONINDEX pour récupérer un handle dans la liste d’images système.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commoncontrols.h
Bibliothèque	Comctl32.lib
DLL	Comctl32.dll

Partager via