ExtractAssociatedIconA-Funktion (shellapi.h)
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.
Syntax
HICON ExtractAssociatedIconA(
[in] HINSTANCE hInst,
[in, out] LPSTR pszIconPath,
[in, out] WORD *piIcon
);
Parameter
[in] hInst
Typ: HINSTANCE-
Ein Handle für die Instanz der aufrufenden Anwendung.
[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 von lpIconPath oder einer zugeordneten ausführbaren Datei verwiesen wurde) den vollständigen Pfad und Dateinamen dieser ausführbaren Datei im Puffer, auf den dieser Parameter verweist.
[in, out] piIcon
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.
Rückgabewert
Typ: HICON-
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Symbolhandle. Wenn das Symbol aus einer zugeordneten ausführbaren Datei extrahiert wird, speichert die Funktion den vollständigen Pfad und Dateinamen der ausführbaren Datei in der Zeichenfolge, auf die durch lpIconPathverwiesen wird, und speichert den Bezeichner des Symbols in der WORD-, auf die von lpiIconverwiesen wird.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-.
Bemerkungen
Wenn sie nicht mehr benötigt wird, ist der Aufrufer dafür verantwortlich, den von ExtractAssociatedIcon zurückgegebenen Symbolhandle durch Aufrufen der DestroyIcon-Funktion freizugeben.
Die funktion ExtractAssociatedIcon sucht zuerst nach dem indizierten Symbol in der datei, die durch lpIconPathangegeben wurde. Wenn die Funktion das Symbolhandle aus dieser Datei nicht abrufen kann und die Datei über eine zugeordnete ausführbare Datei verfügt, sucht sie in dieser ausführbaren Datei nach einem Symbol. Zuordnungen mit ausführbaren Dateien basieren auf Dateinamenerweiterungen und werden im Benutzerteil der Registrierung gespeichert.
Anmerkung
Der shellapi.h-Header definiert ExtractAssociatedIcon 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 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | shellapi.h |
| DLL- | Shell32.dll |
| API-Satz | ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240) |