Função SetupDiGetINFClassA (setupapi.h)

Artigo
11/20/2024

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 no HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion subchave do registro. O comprimento máximo em caracteres, incluindo um terminador NULL, de um nome de arquivo INF encerrado 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 por 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 terminado por NULL, em caracteres, é MAX_CLASS_NAME_LEN.

[out, optional] RequiredSize

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

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

Nota

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. 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

SetupDiBuildClassInfoList

SetupDiClassGuidsFromName

setupDiClassNameFromGuid

setupDiGetClassDescription

Compartilhar via