Función SetupDiBuildClassInfoListExW (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 SetupDiBuildClassInfoListExW(
[in] DWORD Flags,
[out, optional] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize,
[in, optional] PCWSTR 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 de la matriz de 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 del 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 se puede NULL. Si MachineName es NULL, esta función compila una lista de clases instaladas en el equipo local.
Cautela
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 ejecuta correctamente. De lo contrario, devuelve FALSE y se puede recuperar el error registrado realizando una llamada a GetLastError.
Observaciones
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 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 | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
setupapi.h (incluya Setupapi.h) |
| biblioteca de |
Setupapi.lib |