Función SetupDiBuildClassInfoListExA (setupapi.h)

  • Artículo

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

Consulte también

SetupDiBuildClassInfoList

SetupDiGetClassDescriptionEx