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.

Requisitos

Confira também

SetupDiBuildClassInfoList

SetupDiClassGuidsFromName

SetupDiClassNameFromGuid

SetupDiGetClassDescription