Skip to content

Latest commit

 

History

History
122 lines (85 loc) · 4.18 KB

nf-setupapi-setupgetlinebyindexa.md

File metadata and controls

122 lines (85 loc) · 4.18 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name req.apiset
NF:setupapi.SetupGetLineByIndexA
SetupGetLineByIndexA function (setupapi.h)
The SetupGetLineByIndex function locates a line by its index value in the specified section in the INF file. (ANSI)
SetupGetLineByIndexA
setupapi/SetupGetLineByIndexA
setup\setupgetlinebyindex.htm
setup
7a1c313b-3150-4f4f-a1e9-0fc9544b97ab
12/05/2018
SetupGetLineByIndex, SetupGetLineByIndex function [Setup API], SetupGetLineByIndexA, SetupGetLineByIndexW, _setupapi_setupgetlinebyindex, setup.setupgetlinebyindex, setupapi/SetupGetLineByIndex, setupapi/SetupGetLineByIndexA, setupapi/SetupGetLineByIndexW
setupapi.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
SetupGetLineByIndexW (Unicode) and SetupGetLineByIndexA (ANSI)
Setupapi.lib
Setupapi.dll
Windows
19H1
SetupGetLineByIndexA
setupapi/SetupGetLineByIndexA
c++
APIRef
kbSyntax
DllExport
Setupapi.dll
Ext-MS-Win-SetupAPI-ClassInstallers-L1-1-1.dll
Ext-MS-Win-SetupAPI-Inf-L1-1-1.dll
SetupGetLineByIndex
SetupGetLineByIndexA
SetupGetLineByIndexW
ext-ms-win-setupapi-inf-l1-1-1 (introduced in Windows 10, version 10.0.14393)

SetupGetLineByIndexA function

-description

[This function is available for use in the operating systems indicated in the Requirements section. It may be altered or unavailable in subsequent versions. SetupAPI should no longer be used for installing applications. Instead, use the Windows Installer for developing application installers. SetupAPI continues to be used for installing device drivers.]

The SetupGetLineByIndex function locates a line by its index value in the specified section in the INF file.

-parameters

-param InfHandle [in]

Handle to the INF file.

-param Section [in]

Pointer to a null-terminated string specifying the section of the INF file to search.

-param Index [in]

Index of the line to be located. The total number of lines in a particular section can be found with a call to SetupGetLineCount.

-param Context [in, out]

Pointer to a variable that receives the context information for the found line.

-returns

If the function succeeds, the return value is a nonzero value. If the function fails, the return value is zero. To get extended error information, call GetLastError.

-remarks

If InfHandle references multiple INF files that have been appended together using SetupOpenAppendInfFile, this function searches across the specified section in all files referenced by the HINF to locate the indexed line.

Note

The setupapi.h header defines SetupGetLineByIndex as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

-see-also

Functions

Overview

SetupFindFirstLine

SetupFindNextLine

SetupFindNextMatchLine