IAssocHandler::GetIconLocation-Methode (shobjidl_core.h)

Artikel
03/04/2024

Ruft den Speicherort des Symbols ab, das der Anwendung zugeordnet ist.

Syntax

HRESULT GetIconLocation(
  [out] LPWSTR *ppszPath,
  [out] int    *pIndex
);

Parameter

[out] ppszPath

Typ: LPWSTR*

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Pfad zum Symbol der Anwendung enthält.

[out] pIndex

Typ: int*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf den Index des Symbols in der Ressource mit dem Namen in ppszPath.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn das Symbol nicht gefunden werden kann, gibt die Funktion den Pfad zur ausführbaren Datei und einen Symbolindex von 0 zurück.

Aus Leistungsgründen kann eine Anwendung den Shell-Imagecache verwenden, um das Symbol abzurufen, anstatt das Symbol direkt aus dem zurückgegebenen Pfad zu laden. Der Pfad- und Symbolindex kann direkt an Shell_GetCachedImageIndex übergeben werden. Ein Vorteil ist, dass der Shellcache ein Standardsymbol bereitstellen kann, falls kein Symbol für die Anwendung verfügbar war.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)

Freigeben über