Função SetupDiClassNameFromGuidExA (setupapi.h)
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 SetupDiClassNameFromGuidExA(
[in] const GUID *ClassGuid,
[out] PSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize,
[in, optional] PCSTR 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 da classe terminada em NULL 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 terminação). 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, começando com Windows 8 e Windows Server 2012, pois essa funcionalidade foi removida.
Reserved
Deve ser NULL.
Retornar valor
A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado com uma chamada para GetLastError.
Comentários
Observação
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 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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de