Función ExtractAssociatedIconA (shellapi.h)

Obtiene un identificador de un icono almacenado como un recurso en un archivo o un icono almacenado en el archivo ejecutable asociado de un archivo.

Sintaxis

HICON ExtractAssociatedIconA(
  [in]      HINSTANCE hInst,
  [in, out] LPSTR     pszIconPath,
  [in, out] WORD      *piIcon
);

Parámetros

[in] hInst

Tipo: HINSTANCE

Identificador de la instancia de la aplicación que realiza la llamada.

[in, out] pszIconPath

Tipo: LPTSTR

Puntero a una cadena que, en la entrada, especifica la ruta de acceso completa y el nombre de archivo del archivo que contiene el icono. La función extrae el identificador de icono de ese archivo o de un archivo ejecutable asociado a ese archivo.

Cuando esta función devuelve, si el identificador de icono se obtuvo de un archivo ejecutable (ya sea un archivo ejecutable al que apunta lpIconPath o un archivo ejecutable asociado), la función almacena la ruta de acceso completa y el nombre de archivo de ese archivo ejecutable en el búfer al que apunta este parámetro.

[in, out] piIcon

Tipo: LPWORD

Puntero a un valor WORD que, en la entrada, especifica el índice del icono cuyo identificador se va a obtener.

Cuando la función devuelve, si el identificador de icono se obtuvo de un archivo ejecutable (ya sea un archivo ejecutable al que apunta lpIconPath o un archivo ejecutable asociado), este valor apunta al índice del icono en ese archivo.

Valor devuelto

Tipo: HICON

Si la función se ejecuta correctamente, el valor devuelto es un identificador de icono. Si el icono se extrae de un archivo ejecutable asociado, la función almacena la ruta de acceso completa y el nombre de archivo del archivo ejecutable en la cadena a la que apunta lpIconPath y almacena el identificador del icono en la palabra a la que apunta lpiIcon.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

Cuando ya no es necesario, el autor de la llamada es responsable de liberar el identificador de icono devuelto por ExtractAssociatedIcon llamando a la función DestroyIcon .

La función ExtractAssociatedIcon busca primero el icono indizado en el archivo especificado por lpIconPath. Si la función no puede obtener el identificador de icono de ese archivo y el archivo tiene un archivo ejecutable asociado, busca un icono en ese archivo ejecutable. Las asociaciones con archivos ejecutables se basan en extensiones de nombre de archivo y se almacenan en la parte por usuario del registro.

Nota

El encabezado shellapi.h define ExtractAssociatedIcon como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shellapi.h
Archivo DLL	Shell32.dll
Conjunto de API	ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240)

Consulte también

ExtractAssociatedIconEx

ExtractIcon

ExtractIconEx