Função SetupDiClassGuidsFromNameA (setupapi.h)

A função SetupDiClassGuidsFromName recupera os GUID(s) associados ao nome de 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 de 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 retornado

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

Chame SetupDiClassGuidsFromNameEx para recuperar os GUIDs de classe de uma classe em um computador remoto.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
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

Confira também

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid