ImageList_CoCreateInstance-Funktion (commoncontrols.h)

Artikel
08/22/2023

Erstellt eine einzelne instance einer Imageliste und gibt einen Schnittstellenzeiger darauf zurück.

Syntax

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

Parameter

[in] rclsid

Typ: REFCLSID

Ein Verweis auf die CLSID– eine GUID, die das zu erstellende COM-Objekt identifiziert. Dies sollte CLSID_ImageList sein.

[in, optional] punkOuter

Typ: const IUnknown*

Ein Zeiger auf die äußere IUnknown-Schnittstelle , die das von dieser Funktion erstellte Objekt aggregiert, oder NULL , wenn keine Aggregation gewünscht wird.

[in] riid

Typ: REFIID

Verweis auf die gewünschte Schnittstellen-ID.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist normalerweise IImageList2, das die Initialize-Methode bereitstellt.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Vor dem Aufrufen dieser Funktion muss COM durch Aufrufen von CoInitialize oder CoInitializeEx initialisiert werden.

Rufen Sie ImageList_CoCreateInstance für eine benutzerdefinierte Bildliste auf. Rufen Sie andernfalls SHGetImageList auf, um die Systemimageliste zu laden. Rufen Sie SHGetFileInfo auf, wobei der uflag-Parameter auf SHGFI_SYSICONINDEX festgelegt ist, um ein Handle für die Systembildliste abzurufen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commoncontrols.h
Bibliothek	Comctl32.lib
DLL	Comctl32.dll

Share via