Função SetupDiClassNameFromGuidW (setupapi.h)
A função SetupDiClassNameFromGuid recupera o nome da classe associado a um GUID de classe.
Sintaxe
WINSETUPAPI BOOL SetupDiClassNameFromGuidW(
[in] const GUID *ClassGuid,
[out] PWSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Parâmetros
[in] ClassGuid
Um ponteiro para o GUID de classe para o nome da classe a ser recuperado.
[out] ClassName
Um ponteiro para um buffer que recebe a cadeia de caracteres terminada em NULL que contém o nome da classe especificada pelo ponteiro no parâmetro ClassGuid .
[in] ClassNameSize
O tamanho, em caracteres, do buffer apontado pelo parâmetro ClassName . O tamanho máximo, em caracteres, de um nome de classe terminado em NULL é MAX_CLASS_NAME_LEN. Para obter mais informações sobre o tamanho do nome da classe, consulte a seção Comentários a seguir.
[out, optional] RequiredSize
Um ponteiro para uma variável que recebe o número de caracteres necessários para armazenar o nome da classe terminada em NULL solicitada. Esse ponteiro é opcional e pode 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
Chame SetupDiClassNameFromGuidEx para recuperar o nome de uma classe em um computador remoto.
SetupDiClassNameFromGuid não impõe uma restrição ao comprimento do nome da classe que ele pode retornar. Essa função retorna o tamanho necessário para um nome de classe terminado em NULL, mesmo que seja maior que MAX_CLASS_NAME_LEN. No entanto, MAX_CLASS_NAME_LEN é o comprimento máximo de um nome de classe terminado em NULL válido. Um chamador nunca deve precisar de um buffer maior que MAX_CLASS_NAME_LEN. Para obter mais informações sobre nomes de classe, consulte a descrição da entrada Classe de uma seção Versão do INF.
Observação
O cabeçalho setupapi.h define SetupDiClassNameFromGuid 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 |