ExtractIcon

Die ExtractIcon -Funktion Ruft ein Handle für ein Symbol aus der angegebenen ausführbaren Datei, Dynamic-Link Bibliothek (DLL) oder Icon-Datei.

Ein Array von Handles für große oder kleine Symbole abrufen, mithilfe der ExtractIconEx -Funktion.

(HICON ExtractIcon HINSTANCE  hInst, / / Instanz-HandleLPCTSTRlpszExeFileName, / / Dateiname der Datei mit IconUINTnIconIndex / / index des Symbols zu extrahieren);
 

Parameter

hInst

Behandeln Sie, um die Instanz der Anwendung aufrufen der Funktion.

lpszExeFileName

Zeiger auf eine auf Null endende Zeichenfolge angeben den Namen des eine ausführbare Datei, DLL oder Icon-Datei.

nIconIndex

Gibt den nullbasierten Index des Symbols abzurufen. Zum Beispiel, wenn dieser Wert 0 ist, gibt die Funktion einen Handle auf das erste Symbol in der angegebenen Datei.

Wenn dieser Wert 1 ist, gibt die Funktion die Anzahl der Symbole in der angegebenen Datei. Wenn die Datei eine ausführbare Datei oder DLL ist, ist der Rückgabewert die Anzahl der RT_GROUP_ICON Ressourcen. Wenn die Datei ein.ICO-Datei, den zurückgegebenen Wert ist 1.

Windows 95, Windows NT 4.0 und höher: Wenn dieser Wert eine negative Zahl nicht gleich-1 ist, gibt die Funktion einen Handle auf das Symbol in der angegebenen Datei, deren Ressourcen-ID gleich dem absoluten Wert der nIconIndex ist. Verwenden Sie z. B.-3 um das Symbol zu extrahieren, dessen Ressourcenbezeichner 3 ist. Um deren Ressourcen-ID 1 ist das Symbol zu extrahieren, verwenden Sie die ExtractIconEx -Funktion.

Rückgabewerte

Der Rückgabewert ist ein Handle für ein Symbol. Wenn die angegebene Datei nicht um eine ausführbare Datei, DLL oder Icon-Datei war, ist die Rückkehr 1. Wenn keine Symbole in der Datei gefunden wurden, ist der Rückgabewert NULL.

Bemerkungen

Sie müssen das Icon-Handle zurückgegeben von ExtractIcon durch Aufrufen der Funktion DestroyIcon zerstören.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:In shellapi.h deklariert.
Importieren Bibliothek:Verwenden Sie shell32.lib.
Unicode:Als Unicode und ANSI-Versionen unter Windows NT implementiert.

Siehe auch

Übersicht über die Symbole, Symbol Funktionen, DestroyIcon, ExtractIconEx

Index