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

Consulte también

SetupDiBuildClassInfoListEx

SetupDiGetClassDescription

SetupDiGetINFClass