ExtractAssociatedIconExW-Funktion (shellapi.h)

  • Artikel

[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 für ein Symbol ab, das als Ressource in einer Datei gespeichert ist, oder ein Symbol, das in der zugeordneten ausführbaren Datei einer Datei gespeichert ist. Die ExtractAssociatedIcon-Funktion wird erweitert, indem die ID des Symbols abgerufen wird, wenn dieses Symbol aus einer ausführbaren Datei extrahiert wird.

Syntax

HICON ExtractAssociatedIconExW(
  [in]      HINSTANCE hInst,
  [in, out] LPWSTR    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

Zeiger auf eine Zeichenfolge, die bei der Eingabe 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 und das Symbolhandle aus einer ausführbaren Datei abgerufen wurde (entweder aus einer ausführbaren Datei, auf die dieser Parameter direkt verweist, oder einer zugeordneten ausführbaren Datei), speichert die Funktion den vollständigen Pfad und Dateinamen dieser ausführbaren Datei in dem Puffer, auf den dieser Parameter verweist.

[in, out] piIconIndex

Typ: LPWORD

Zeiger auf einen WORD-Wert , der bei einem Eintrag den Index des Symbols angibt, dessen Handle abgerufen werden soll.

Wenn die Funktion zurückgegeben wird und das Symbolhandle aus einer ausführbaren Datei abgerufen wurde (entweder aus einer ausführbaren Datei, auf die von lpIconPath oder einer zugeordneten ausführbaren Datei verwiesen wird), verweist dieser Wert auf den Index des Symbols in dieser Datei.

[in, out] piIconId

Typ: LPWORD

Zeiger auf einen WORD-Wert , der bei der Eingabe die ID des Symbols angibt, dessen Handle abgerufen werden soll.

Wenn die Funktion zurückgegeben wird und das Symbolhandle aus einer ausführbaren Datei abgerufen wurde (entweder aus einer ausführbaren Datei, auf die von lpIconPath oder einer zugeordneten ausführbaren Datei verwiesen wird), verweist dieser Wert auf die ID des Symbols in dieser Datei.

Rückgabewert

Typ: HICON

Gibt bei erfolgreicher Ausführung das Handle des Symbols zurück, andernfalls NULL.

Hinweise

Das von dieser Funktion zurückgegebene Symbolhandle muss durch Aufrufen von DestroyIcon freigegeben werden, wenn es nicht mehr benötigt wird.

Hinweis

Der Shellapi.h-Header 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
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shellapi.h
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

ExtractAssociatedIcon

ExtractIcon

ExtractIconEx