Função SetupOpenInfFileA (setupapi.h)

Artigo
08/26/2023

[Essa função está disponível para uso nos sistemas operacionais indicados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. SetupAPI não deve mais ser usado para instalar aplicativos. Em vez disso, use o Windows Installer para desenvolver instaladores de aplicativos. SetupAPI continua a ser usado para instalar drivers de dispositivo.]

A função SetupOpenInfFile abre um arquivo INF e retorna um identificador para ele.

Sintaxe

WINSETUPAPI HINF SetupOpenInfFileA(
  [in] PCSTR FileName,
  [in] PCSTR InfClass,
  [in] DWORD InfStyle,
  [in] PUINT ErrorLine
);

Parâmetros

[in] FileName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome (e o caminho opcional) do arquivo INF a ser aberto. Se o nome do arquivo não contiver caracteres separadores de caminho, ele será pesquisado, primeiro no diretório %windir%\inf e, em seguida, no diretório %windir%\system32. Se o nome do arquivo contiver caracteres separadores de caminho, presume-se que seja uma especificação de caminho completo e nenhum processamento adicional será executado nele.

[in] InfClass

Ponteiro opcional para uma cadeia de caracteres terminada em nulo que contém a classe de arquivo INF desejada. Essa cadeia de caracteres deve corresponder ao valor de Classe da seção Versão (por exemplo, Class=Net). Se não houver nenhuma entrada no valor classe, mas houver uma entrada para ClassGUID na seção Versão , o nome de classe correspondente para esse GUID será recuperado e usado para a comparação.

[in] InfStyle

Estilo do arquivo INF para abrir ou pesquisar. Esse parâmetro pode ser uma combinação dos sinalizadores a seguir.

INF_STYLE_OLDNT

Um formato de arquivo INF herdado.

INF_STYLE_WIN4

Um formato de arquivo INF do Windows.

[in] ErrorLine

Ponteiro opcional para uma variável para a qual essa função retorna o número de linha (baseado em 1) em que ocorreu um erro durante o carregamento do arquivo INF. Esse valor geralmente será confiável somente se GetLastError não retornar ERROR_NOT_ENOUGH_MEMORY. Se ocorrer uma condição fora da memória, ErrorLine poderá ser 0.

Retornar valor

A função retornará um identificador para o arquivo INF aberto se for bem-sucedida. Caso contrário, o valor retornado será INVALID_HANDLE_VALUE. Informações de erro estendidas podem ser recuperadas por uma chamada para GetLastError.

Comentários

Se a carga falhar porque o tipo de arquivo INF não corresponde ao InfClass, a função retornará INVALID_HANDLE_VALUE e uma chamada para GetLastError retornará ERROR_CLASS_MISMATCH.

Se vários estilos de arquivo INF forem especificados, o estilo do arquivo INF aberto poderá ser determinado chamando a função SetupGetInfInformation .

Como pode haver mais de um GUID de classe com o mesmo nome de classe, os chamadores interessados em arquivos INF de uma classe específica (ou seja, um GUID de classe específico) devem recuperar o valor ClassGUID do arquivo INF chamando SetupQueryInfVersionInformation.

Para arquivos INF herdados, a cadeia de caracteres InfClass deve corresponder ao tipo especificado no valor OptionType da seção Identificação no arquivo INF (por exemplo, OptionType=NetAdapter).

Observação

O cabeçalho setupapi.h define SetupOpenInfFile 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	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	setupapi.h
Biblioteca	Setupapi.lib
DLL	Setupapi.dll
Conjunto de APIs	ext-ms-win-setupapi-inf-l1-1-0 (introduzido em Windows 8)