Função SetupDiClassGuidsFromNameExW (setupapi.h)

Artigo
11/20/2024

A função SetupDiClassGuidsFromNameEx recupera os GUIDs associados ao nome da classe especificado. Esta lista resultante contém as classes instaladas atualmente em um computador local ou remoto.

Sintaxe

WINSETUPAPI BOOL SetupDiClassGuidsFromNameExW(
  [in]           PCWSTR ClassName,
  [out]          LPGUID ClassGuidList,
  [in]           DWORD  ClassGuidListSize,
  [out]          PDWORD RequiredSize,
  [in, optional] PCWSTR MachineName,
                 PVOID  Reserved
);

Parâmetros

[in] ClassName

O nome da classe para a qual recuperar os GUIDs 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

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.

[in, optional] MachineName

Um ponteiro para uma cadeia de caracteres terminada em NULL que contém o nome de um sistema remoto do qual recuperar os GUIDs. Esse parâmetro é opcional e pode ser NULL. Se MachineName for NULL, o nome do sistema local será usado.

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

Não há garantia de que os nomes de classe sejam exclusivos; somente GUIDs são exclusivos. Portanto, um nome de classe pode retornar mais de um GUID.

Nota

O cabeçalho setupapi.h define SetupDiClassGuidsFromNameEx 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

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx

Compartilhar via