Función SetupDiBuildClassInfoList (setupapi.h)
La función SetupDiBuildClassInfoList devuelve una lista de GUID de clase de instalación que identifican las clases instaladas en un equipo local.
Sintaxis
WINSETUPAPI BOOL SetupDiBuildClassInfoList(
[in] DWORD Flags,
[out, optional] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize
);
Parámetros
[in] Flags
Marcas usadas para controlar la exclusión de clases de la lista. Si no se especifica ninguna marca, 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 una matriz con tipo GUID que recibe una lista de GUID de clase de instalación. Este puntero es opcional y puede ser NULL.
[in] ClassGuidListSize
Número de GUID de la matriz a la que apunta el parámetro ClassGuildList . Si ClassGuidList es NULL, ClassGuidSize debe ser cero.
[out] RequiredSize
Puntero a una variable con tipo DWORD que recibe el número de GUID que se devuelven (si el número es menor o igual que el tamaño, en GUID, de la matriz a la que apunta el parámetro ClassGuidList ).
Si este número es mayor que el tamaño de la matriz ClassGuidList , indica el tamaño que debe tener la matriz ClassGuidList para contener todos los GUID de clase.
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
Para recuperar el número de clases instaladas en un equipo local, llame a SetupDiBuildClassInfoList con ClassGuidList establecido en NULL y ClassGuidSize establecido en cero. En respuesta a esta llamada, la función devuelve el número de clases en *RequiredSize.
SetupDiBuildClassInfoList no devuelve un GUID de clase para una clase si la entrada de valor NoUseClass existe en la clave del Registro de la clase.
Para recuperar la lista de GUID de clase de instalación instalados en un sistema remoto, use SetupDiBuildClassInfoListEx.
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 |
| Archivo DLL | Setupapi.dll |