ExtractAssociatedIconExA-Funktion (shellapi.h)
[ExtractAssociatedIconEx ist für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Ruft ein Handle zu einem Symbol ab, das als Ressource in einer Datei oder einem Symbol in der zugeordneten ausführbaren Datei einer Datei gespeichert ist. Sie erweitert die ExtractAssociatedIcon--Funktion, indem die ID des Symbols abgerufen wird, wenn dieses Symbol aus einer ausführbaren Datei extrahiert wird.
Syntax
HICON ExtractAssociatedIconExA(
[in] HINSTANCE hInst,
[in, out] LPSTR pszIconPath,
[in, out] WORD *piIconIndex,
[in, out] WORD *piIconId
);
Parameter
[in] hInst
Typ: HINSTANCE-
Das Handle des Moduls, aus dem das Symbol extrahiert werden soll.
[in, out] pszIconPath
Typ: LPTSTR-
Zeigen Sie auf eine Zeichenfolge, die beim Eintrag den vollständigen Pfad und Dateinamen der Datei angibt, die das Symbol enthält. Die Funktion extrahiert das Symbolhandle aus dieser Datei oder aus einer ausführbaren Datei, die dieser Datei zugeordnet ist.
Wenn diese Funktion zurückgegeben wird, speichert die Funktion, wenn das Symbolhandle aus einer ausführbaren Datei abgerufen wurde (entweder eine ausführbare Datei, auf die direkt von diesem Parameter oder einer zugeordneten ausführbaren Datei verwiesen wird) den vollständigen Pfad und Dateinamen dieser ausführbaren Datei im Puffer gespeichert, auf den dieser Parameter verweist.
[in, out] piIconIndex
Typ: LPWORD-
Zeiger auf einen WORD- Wert, der beim Eintrag den Index des Symbols angibt, dessen Handle abgerufen werden soll.
Wenn die Funktion zurückgegeben wird, wenn das Symbolhandle aus einer ausführbaren Datei abgerufen wurde (entweder eine ausführbare Datei, auf die von lpIconPath oder einer zugeordneten ausführbaren Datei verwiesen wurde), verweist dieser Wert auf den Index des Symbols in dieser Datei.
[in, out] piIconId
Typ: LPWORD-
Zeigen Sie auf einen WORD- Wert, der beim Eintrag die ID des Symbols angibt, dessen Handle abgerufen werden soll.
Wenn die Funktion zurückgegeben wird, wenn das Symbolhandle aus einer ausführbaren Datei abgerufen wurde (entweder eine ausführbare Datei, auf die von lpIconPath oder einer zugeordneten ausführbaren Datei verwiesen wurde), verweist dieser Wert auf die ID des Symbols innerhalb dieser Datei.
Rückgabewert
Typ: HICON-
Gibt das Handle des Symbols zurück, wenn das Symbol erfolgreich verläuft, andernfalls NULL-.
Bemerkungen
Das von dieser Funktion zurückgegebene Symbolhandle muss durch Aufrufen von DestroyIcon freigegeben werden, wenn es nicht mehr benötigt wird.
Anmerkung
Der header shellapi.h definiert ExtractAssociatedIconEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | shellapi.h |
| Library | Shell32.lib |
| DLL- | Shell32.dll (Version 5.0 oder höher) |