Função SetupDiClassGuidsFromNameW (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 SetupDiClassGuidsFromNameW(
  [in]  PCWSTR 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.

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

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

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

Confira também

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid