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 de

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 de

Puntero a un valor de 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 lpIconPathy almacena el identificador del icono en el WORD apuntado por lpiIcon.

Si se produce un error en la función, el valor devuelto es NULL.

Observaciones

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 de 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 en ese archivo ejecutable un icono. 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shellapi.h
DLL de	Shell32.dll
conjunto de API de	ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240)

Consulte también

extractAssociatedIconEx

ExtractIcon

ExtractIconEx