Função SetupDiClassGuidsFromNameA (setupapi.h)
A função SetupDiClassGuidsFromName recupera os GUID(s) associados ao nome da classe especificado. Essa lista é criada com base nas classes instaladas atualmente no sistema.
Sintaxe
WINSETUPAPI BOOL SetupDiClassGuidsFromNameA(
[in] PCSTR ClassName,
[out] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize
);
Parâmetros
[in] ClassName
O nome da classe para a qual recuperar o GUID de classe.
[out] ClassGuidList
Um ponteiro para uma matriz para receber a lista de GUIDs associados ao nome da classe especificado.
[in] ClassGuidListSize
O número de GUIDs na matriz ClassGuidList
[out] RequiredSize
Fornece um ponteiro para uma variável que recebe o número de GUIDs associados ao nome da classe. Se esse número for maior que o tamanho do buffer ClassGuidList, o número indicará o tamanho da matriz para armazenar todos os GUIDs.
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
Chame SetupDiClassGuidsFromNameEx para recuperar os GUIDs de classe de uma classe em um computador remoto.
Nota
O cabeçalho setupapi.h define SetupDiClassGuidsFromName 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
setupDiClassNameFromGuid