Função SetupDiGetINFClassA (setupapi.h)

A função SetupDiGetINFClass retorna a classe de um arquivo INF do dispositivo especificado.

Sintaxe

WINSETUPAPI BOOL SetupDiGetINFClassA(
  [in]            PCSTR  InfName,
  [out]           LPGUID ClassGuid,
  [out]           PSTR   ClassName,
  [in]            DWORD  ClassNameSize,
  [out, optional] PDWORD RequiredSize
);

Parâmetros

[in] InfName

Um ponteiro para uma cadeia de caracteres terminada em NULL que fornece o nome de um arquivo INF do dispositivo. Esse nome pode incluir um caminho. No entanto, se apenas o nome do arquivo for especificado, o arquivo será pesquisado em cada diretório listado na entrada DevicePath na subchave HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion do registro. O comprimento máximo em caracteres, incluindo um terminador NULL, de um nome de arquivo INF terminado em NULL é MAX_PATH.

[out] ClassGuid

Um ponteiro para uma variável do tipo GUID que recebe o GUID de classe para o arquivo INF especificado. Se o arquivo INF não especificar um nome de classe, a função retornará uma estrutura GUID_NULL. Chame SetupDiClassGuidsFromName para determinar se uma ou mais classes com esse nome já estão instaladas.

[out] ClassName

Um ponteiro para um buffer que recebe uma cadeia de caracteres terminada em NULL que contém o nome da classe para o arquivo INF especificado. Se o arquivo INF não especificar um nome de classe, mas especificar um GUID, esse buffer receberá o nome recuperado chamando SetupDiClassNameFromGuid. No entanto, se SetupDiClassNameFromGuid não puder recuperar um nome de classe (por exemplo, a classe não está instalada), ela retornará uma cadeia de caracteres vazia.

[in] ClassNameSize

O tamanho, em caracteres, do buffer apontado pelo parâmetro ClassName . O comprimento máximo de um nome de classe terminada em NULL, em caracteres, é MAX_CLASS_NAME_LEN.

[out, optional] RequiredSize

Um ponteiro para uma variável do tipo DWORD que recebe o número de caracteres necessários para armazenar o nome da classe, incluindo um NULL de terminação. 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

Não use essa função com arquivos INF para Windows 9x ou Millennium Edition.

Observação

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

SetupDiBuildClassInfoList

SetupDiClassGuidsFromName

SetupDiClassNameFromGuid

SetupDiGetClassDescription