Función CreateIconIndirect (winuser.h)

Artículo
03/09/2024

Crea un icono o cursor a partir de una estructura ICONINFO .

Sintaxis

HICON CreateIconIndirect(
  [in] PICONINFO piconinfo
);

Parámetros

[in] piconinfo

Tipo: PICONINFO

Puntero a una estructura ICONINFO que usa la función para crear el icono o el cursor.

Valor devuelto

Tipo: HICON

Si la función se ejecuta correctamente, el valor devuelto es un identificador del icono o cursor que se crea.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El sistema copia los mapas de bits en la estructura ICONINFO antes de crear el icono o el cursor. Dado que el sistema puede seleccionar temporalmente los mapas de bits en un contexto de dispositivo, los miembros hbmMask y hbmColor de la estructura ICONINFO aún no deben seleccionarse en un contexto de dispositivo. La aplicación debe seguir administrando los mapas de bits originales y eliminarlos cuando ya no sean necesarios.

Cuando haya terminado de usar el icono, destruyalo mediante la función DestroyIcon .

Ejemplos

Para obtener un ejemplo, vea Crear un cursor.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-gui-l1-3-0 (introducido en Windows 10, versión 10.0.10240)