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) |