Función SetupDiGetClassImageListExA (setupapi.h)

  • Artículo

La función SetupDiGetClassImageListEx crea una lista de imágenes de mapas de bits para cada clase instalada en un sistema local o remoto.

Sintaxis

WINSETUPAPI BOOL SetupDiGetClassImageListExA(
  [out]          PSP_CLASSIMAGELIST_DATA ClassImageListData,
  [in, optional] PCSTR                   MachineName,
                 PVOID                   Reserved
);

Parámetros

[out] ClassImageListData

Puntero a una estructura de SP_CLASSIMAGELIST_DATA para recibir información sobre la lista de imágenes de clase, incluido un identificador de la lista de imágenes. El campo cbSize de esta estructura debe inicializarse con el tamaño de la estructura, en bytes, antes de llamar a esta función o se producirá un error.

[in, optional] MachineName

Puntero a una cadena terminada en NULL que proporciona el nombre de un sistema remoto para cuyas clases SetupDiGetClassImageListEx deben compilar el mapa de bits. Este parámetro es opcional y puede ser NULL. Si MachineName es NULL, SetupDiGetClassImageListEx compila la lista para el sistema local.

Precaución

No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.

Reserved

Debe ser NULL.

Valor devuelto

La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar mediante una llamada a GetLastError.

Comentarios

La lista de imágenes compilada por esta función debe destruirse llamando a SetupDiDestroyClassImageList.

Nota Los iconos específicos de clase en un equipo remoto solo se pueden mostrar si la clase también está presente en el equipo local. Por lo tanto, si el equipo remoto tiene la clase X, pero la clase X no está instalada localmente, se devolverá el icono genérico (desconocido).
 

Nota

El encabezado setupapi.h define SetupDiGetClassImageListEx 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 Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado setupapi.h (incluya Setupapi.h)
Library Setupapi.lib

Consulte también

SetupDiDestroyClassImageList

SetupDiGetClassImageList