Função SetupDiBuildClassInfoListExA (setupapi.h)

Artigo
11/20/2024

A função SetupDiBuildClassInfoListEx retorna uma lista de GUIDs de classe de instalação que inclui todas as classes instaladas no sistema local ou em um sistema remoto.

Sintaxe

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

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 um buffer que recebe uma lista de GUIDs de classe de instalação.

[in] ClassGuidListSize

Fornece o número de GUIDs na matriz ClassGuildList.

[out] RequiredSize

Um ponteiro para uma variável que recebe o número de GUIDs retornados. Se esse número for maior que o tamanho doclassGuidList , o número indicará o tamanho da matriz ClassGuidList deve ser para conter a lista.

[in, optional] MachineName

Um ponteiro para uma cadeia de caracteres terminada em NULL que contém o nome de um computador remoto do qual recuperar classes de instalação instaladas. Esse parâmetro é opcional e pode ser NULL. Se machinename for NULL, essa função criará uma lista de classes instaladas no computador local.

Cuidado

Não há suporte para o uso dessa função para acessar computadores remotos a partir do Windows 8 e do Windows Server 2012, pois essa funcionalidade foi removida.

Reserved

Deve ser NULL.

Valor de retorno

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.

Observações

Nota

O cabeçalho setupapi.h define SetupDiBuildClassInfoListEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	setupapi.h (inclua Setupapi.h)
biblioteca	Setupapi.lib

Consulte também

SetupDiBuildClassInfoList

SetupDiGetClassDescriptionEx

Compartilhar via