funzione ImageList_CoCreateInstance (commoncontrols.h)

Articolo
08/22/2023

Crea una singola istanza di un elenco di immagini e restituisce un puntatore dell'interfaccia.

Sintassi

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

Parametri

[in] rclsid

Tipo: REFCLSID

Riferimento a CLSID, un GUID che identifica l'oggetto COM da creare. Questo deve essere CLSID_ImageList.

[in, optional] punkOuter

Tipo: const IUnknown*

Puntatore all'interfaccia IUnknown esterna che aggrega l'oggetto creato da questa funzione o NULL se non è desiderata alcuna aggregazione.

[in] riid

Tipo: REFIID

Riferimento all'ID dell'interfaccia desiderato.

[out] ppv

Tipo: void**

Quando questo metodo restituisce, contiene il puntatore dell'interfaccia richiesto in riid. Questo è normalmente IImageList2, che fornisce il metodo Initialize .

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Prima di chiamare questa funzione, COM deve essere inizializzato chiamando CoInitialize o CoInitializeEx.

Chiamare ImageList_CoCreateInstance per un elenco di immagini personalizzate; in caso contrario, chiamare SHGetImageList per caricare l'elenco di immagini di sistema. Chiamare SHGetFileInfo con il parametro uflag impostato su SHGFI_SYSICONINDEX per recuperare un handle nell'elenco di immagini di sistema.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commoncontrols.h
Libreria	Comctl32.lib
DLL	Comctl32.dll

Share via