Función SetupDiBuildClassInfoListExA (setupapi.h)
La función SetupDiBuildClassInfoListEx devuelve una lista de GUID de clase de instalación que incluye todas las clases instaladas en el sistema local o en un sistema remoto.
Sintaxis
WINSETUPAPI BOOL SetupDiBuildClassInfoListExA(
[in] DWORD Flags,
[out, optional] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parámetros
[in] Flags
Marcas usadas para controlar la exclusión de clases de la lista. Si no se especifican marcas, todas las clases de instalación se incluyen en la lista. Puede ser una combinación de los valores siguientes:
DIBCI_NOINSTALLCLASS
Excluya una clase si tiene la entrada de valor NoInstallClass en su clave del Registro.
DIBCI_NODISPLAYCLASS
Excluya una clase si tiene la entrada de valor NoDisplayClass en su clave del Registro.
[out, optional] ClassGuidList
Puntero a un búfer que recibe una lista de GUID de clase de instalación.
[in] ClassGuidListSize
Proporciona el número de GUID en la matriz ClassGuildList .
[out] RequiredSize
Puntero a una variable que recibe el número de GUID devueltos. Si este número es mayor que el tamaño de ClassGuidList, el número indica el tamaño de la matriz ClassGuidList para contener la lista.
[in, optional] MachineName
Puntero a una cadena terminada en NULL que contiene el nombre de un equipo remoto desde el que recuperar las clases de instalación instaladas. Este parámetro es opcional y puede ser NULL. Si MachineName es NULL, esta función crea una lista de clases instaladas en el equipo 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 realizando una llamada a GetLastError.
Comentarios
Nota
El encabezado setupapi.h define SetupDiBuildClassInfoListEx 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 |