Função SetupDiClassNameFromGuidExW (setupapi.h)

Artigo
11/20/2024

A função SetupDiClassNameFromGuidEx recupera o nome da classe associado a um GUID de classe. A classe pode ser instalada em um computador local ou remoto.

Sintaxe

WINSETUPAPI BOOL SetupDiClassNameFromGuidExW(
  [in]            const GUID *ClassGuid,
  [out]           PWSTR      ClassName,
  [in]            DWORD      ClassNameSize,
  [out, optional] PDWORD     RequiredSize,
  [in, optional]  PCWSTR     MachineName,
                  PVOID      Reserved
);

Parâmetros

[in] ClassGuid

O GUID de classe do nome da classe a ser recuperado.

[out] ClassName

Um ponteiro para um buffer de cadeia de caracteres que recebe o nome encerrado por NULL da classe para o GUID especificado.

[in] ClassNameSize

O tamanho, em caracteres, do buffer ClassName.

[out, optional] RequiredSize

O número de caracteres necessários para armazenar o nome da classe (incluindo um nulo de encerramento). RequiredSize é sempre menor que MAX_CLASS_NAME_LEN.

[in, optional] MachineName

Um ponteiro para uma cadeia de caracteres terminada em NULL que contém o nome de um sistema remoto no qual a classe está instalada. 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 retorna FALSE e o erro registrado pode ser recuperado com uma chamada para GetLastError.

Observações

Nota

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

SetupDiClassGuidsFromNameEx

setupDiClassNameFromGuid

Compartilhar via