CreateIconFromResource-Funktion (winuser.h)

Artikel
02/01/2024

Erstellt ein Symbol oder Cursor aus Ressourcenbits, die das Symbol beschreiben.

Um eine gewünschte Höhe oder Breite anzugeben, verwenden Sie die Funktion CreateIconFromResourceEx .

Syntax

HICON CreateIconFromResource(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer
);

Parameter

[in] presbits

Typ: PBYTE

Der DWORD-ausgerichtete Pufferzeiger, der das Symbol oder die Cursorressourcenbits enthält. Diese Bits werden in der Regel durch Aufrufe der Funktionen LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx und LoadResource geladen.

Weitere Informationen zum Symbol - und Cursorressourcenformat finden Sie unter Cursor- und Symbolressourcenressourcen.

[in] dwResSize

Art: DWORD

Die Größe der Bitmenge in Bytes, auf die der presbits-Parameter verweist.

[in] fIcon

Typ: BOOL

Gibt an, ob ein Symbol oder ein Cursor erstellt werden soll. Wenn dieser Parameter TRUE ist, wird ein Symbol erstellt. Wenn es FALSE ist, soll ein Cursor erstellt werden.

Die LOCALHEADER-Struktur definiert den Cursor-Hotspot und ist die ersten Daten, die aus den Cursorressourcenbits gelesen werden.

[in] dwVer

Art: DWORD

Die Versionsnummer des Symbols oder Cursorformats für die Ressourcenbits, auf die vom presbits-Parameter verwiesen wird. Der Wert muss größer oder gleich 0x00020000 und kleiner als oder gleich 0x00030000 sein. Dieser Parameter ist im Allgemeinen auf 0x00030000 festgelegt.

Rückgabewert

Typ: HICON

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das Symbol oder den Cursor.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Mit den Funktionen CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LookupIconIdFromDirectory und LookupIconIdFromDirectoryEx können Shellanwendungen und Symbolbrowser Ressourcen im gesamten System untersuchen und verwenden.

Die CreateIconFromResource-Funktion ruft CreateIconFromResourceEx auf, die als Flags übergeben LR_DEFAULTSIZE|LR_SHARED wird.

Sie sollten DestroyIcon für Symbole oder DestroyCursor für Cursor aufrufen, die mit CreateIconFromResource erstellt wurden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll