ExtractIconA-Funktion (shellapi.h)

  • Artikel

Ruft ein Handle für ein Symbol aus der angegebenen ausführbaren Datei, DLL oder Symboldatei ab.

Verwenden Sie die ExtractIconEx-Funktion , um ein Array von Handlen für große oder kleine Symbole abzurufen.

Syntax

HICON ExtractIconA(
  [in] HINSTANCE hInst,
  [in] LPCSTR    pszExeFileName,
       UINT      nIconIndex
);

Parameter

[in] hInst

Typ: HINSTANCE

Behandeln Sie den instance der Anwendung, die die Funktion aufruft.

[in] pszExeFileName

Typ: LPCTSTR

Zeiger auf eine NULL-Zeichenfolge, die den Namen einer ausführbaren Datei, DLL oder Symboldatei angibt.

nIconIndex

Typ: UINT

Gibt den nullbasierten Index des abzurufenden Symbols an. Wenn dieser Wert beispielsweise 0 ist, gibt die Funktion ein Handle an das erste Symbol in der angegebenen Datei zurück.

Wenn dieser Wert -1 ist, gibt die Funktion die Gesamtzahl der Symbole in der angegebenen Datei zurück. Wenn es sich bei der Datei um eine ausführbare Datei oder DLL handelt, ist der Rückgabewert die Anzahl RT_GROUP_ICON Ressourcen. Wenn die Datei ein ist. ICO-Datei, der Rückgabewert ist 1.

Wenn dieser Wert eine negative Zahl ist, die nicht gleich -1 ist, gibt die Funktion ein Handle an das Symbol in der angegebenen Datei zurück, dessen Ressourcenbezeichner dem absoluten Wert von nIconIndex entspricht. Sie sollten beispielsweise –3 verwenden, um das Symbol zu extrahieren, dessen Ressourcenbezeichner 3 ist. Um das Symbol zu extrahieren, dessen Ressourcenbezeichner 1 ist, verwenden Sie die ExtractIconEx-Funktion .

Rückgabewert

Typ: HICON

Der Rückgabewert ist ein Handle für ein Symbol. Wenn die angegebene Datei keine ausführbare Datei, DLL oder Symboldatei war, ist die Rückgabe 1. Wenn keine Symbole in der Datei gefunden wurden, ist der Rückgabewert NULL.

Hinweise

Wenn es nicht mehr benötigt wird, müssen Sie das von ExtractIcon zurückgegebene Symbolhandle zerstören, indem Sie die DestroyIcon-Funktion aufrufen.

Hinweis

Der shellapi.h-Header definiert ExtractIcon als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shellapi.h
DLL Shell32.dll
APIs ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

ExtractAssociatedIcon

ExtractAssociatedIconEx

ExtractIconEx