Função SetupDiBuildClassInfoList (setupapi.h)

A função SetupDiBuildClassInfoList retorna uma lista de GUIDs da classe de instalação que identificam as classes instaladas em um computador local.

Sintaxe

WINSETUPAPI BOOL SetupDiBuildClassInfoList(
  [in]            DWORD  Flags,
  [out, optional] LPGUID ClassGuidList,
  [in]            DWORD  ClassGuidListSize,
  [out]           PDWORD RequiredSize
);

Parâmetros

[in] Flags

Sinalizadores usados para controlar a exclusão de classes da lista. Se nenhum sinalizador for especificado, todas as classes de instalação serão incluídas na lista. Pode ser uma combinação dos seguintes valores:

DIBCI_NOINSTALLCLASS

Exclua uma classe se ela tiver a entrada de valor NoInstallClass em sua chave do Registro.

DIBCI_NODISPLAYCLASS

Exclua uma classe se ela tiver a entrada de valor NoDisplayClass em sua chave do Registro.

[out, optional] ClassGuidList

Um ponteiro para uma matriz do tipo GUID que recebe uma lista de GUIDs da classe de instalação. Esse ponteiro é opcional e pode ser NULL.

[in] ClassGuidListSize

O número de GUIDs na matriz apontada pelo parâmetro ClassGuildList . Se ClassGuidList for NULL, ClassGuidSize deverá ser zero.

[out] RequiredSize

Um ponteiro para uma variável do tipo DWORD que recebe o número de GUIDs retornados (se o número for menor ou igual ao tamanho, em GUIDs, da matriz apontada pelo parâmetro ClassGuidList ).

Se esse número for maior que o tamanho da matriz ClassGuidList , ele indicará o tamanho da matriz ClassGuidList para conter todos os GUIDs de classe.

Retornar valor

A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado fazendo uma chamada para GetLastError.

Comentários

Para recuperar o número de classes instaladas em um computador local, chame SetupDiBuildClassInfoList com ClassGuidList definido como NULL e ClassGuidSize definido como zero. Em resposta a essa chamada, a função retorna o número de classes em *RequiredSize.

SetupDiBuildClassInfoList não retornará um GUID de classe para uma classe se a entrada de valor NoUseClass existir na chave do Registro da classe .

Para recuperar a lista de GUIDs da classe de instalação instalada em um sistema remoto, use SetupDiBuildClassInfoListEx.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	setupapi.h (inclua Setupapi.h)
Biblioteca	Setupapi.lib
DLL	Setupapi.dll

Confira também

SetupDiBuildClassInfoListEx

SetupDiGetClassDescription

SetupDiGetINFClass