Función ExtractAssociatedIconExA (shellapi.h)
[ExtractAssociatedIconEx está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.
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. Extiende la función ExtractAssociatedIcon recuperando el identificador del icono cuando ese icono se extrae de un archivo ejecutable.
Sintaxis
HICON ExtractAssociatedIconExA(
[in] HINSTANCE hInst,
[in, out] LPSTR pszIconPath,
[in, out] WORD *piIconIndex,
[in, out] WORD *piIconId
);
Parámetros
[in] hInst
Tipo: HINSTANCE
Identificador del módulo desde el que se va a extraer el icono.
[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 directamente este parámetro 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] piIconIndex
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.
[in, out] piIconId
Tipo: LPWORD
Puntero a un valor de WORD que, en la entrada, especifica el identificador 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 identificador del icono dentro de ese archivo.
Valor devuelto
Tipo: HICON
Devuelve el identificador del icono si se ejecuta correctamente; de lo contrario, NULL.
Comentarios
El identificador de icono devuelto por esta función debe liberarse llamando a DestroyIcon cuando ya no sea necesario.
Nota
El encabezado shellapi.h define ExtractAssociatedIconEx 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 Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shellapi.h |
| Library | Shell32.lib |
| Archivo DLL | Shell32.dll (versión 5.0 o posterior) |