Share via

Función ExtractAssociatedIconExA (shellapi.h)

  • Artículo

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

Consulte también

ExtractAssociatedIcon

ExtractIcon

ExtractIconEx