Função SetupGetLineByIndexA (setupapi.h)
[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 SetupGetLineByIndex localiza uma linha por seu valor de índice na seção especificada no arquivo INF.
Sintaxe
WINSETUPAPI BOOL SetupGetLineByIndexA(
[in] HINF InfHandle,
[in] PCSTR Section,
[in] DWORD Index,
[in, out] PINFCONTEXT Context
);
Parâmetros
[in] InfHandle
Manipule para o arquivo INF.
[in] Section
Ponteiro para uma cadeia de caracteres terminada em nulo especificando a seção do arquivo INF a ser pesquisado.
[in] Index
Índice da linha a ser localizada. O número total de linhas em uma seção específica pode ser encontrado com uma chamada para SetupGetLineCount.
[in, out] Context
Ponteiro para uma variável que recebe as informações de contexto da linha encontrada.
Retornar valor
Se a função for bem-sucedida, o valor retornado será um valor diferente de zero. Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Se o InfHandle fizer referência a vários arquivos INF que foram acrescentados usando SetupOpenAppendInfFile, essa função pesquisará na seção especificada em todos os arquivos referenciados pelo HINF para localizar a linha indexada.
Observação
O cabeçalho setupapi.h define SetupGetLineByIndex 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-1 (introduzido no Windows 10, versão 10.0.14393) |