Compartir a través de

Método IAssocHandler::GetIconLocation (shobjidl_core.h)

  • Artículo

Recupera la ubicación del icono asociado a la aplicación.

Sintaxis

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

Parámetros

[out] ppszPath

Tipo: LPWSTR*

Cuando este método vuelve, contiene la dirección de un puntero a una cadena Unicode terminada en null que contiene la ruta de acceso al icono de la aplicación.

[out] pIndex

Tipo: int*

Cuando este método vuelve, contiene un puntero al índice del icono dentro del recurso denominado en ppszPath.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Si no se encuentra el icono, la función devolverá la ruta de acceso al archivo ejecutable y un índice de icono de cero.

Por motivos de rendimiento, una aplicación puede usar la memoria caché de imágenes de Shell para recuperar el icono, en lugar de cargar el icono directamente desde la ruta de acceso devuelta. La ruta de acceso y el índice de icono se pueden pasar directamente a Shell_GetCachedImageIndex. Una ventaja de esto es que la memoria caché de Shell puede proporcionar un icono predeterminado en caso de que no haya ningún icono disponible para la aplicación.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)