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 |