SetupFindNextLine-Funktion (setupapi.h)

Artikel
08/26/2023

[Diese Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. SetupAPI sollte nicht mehr für die Installation von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Anwendungsinstallationsprogrammen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]

SetupFindNextLine gibt den Speicherort der nächsten Zeile in einem INF-Dateiabschnitt relativ zu ContextIn.Line zurück.

Syntax

WINSETUPAPI BOOL SetupFindNextLine(
  [in]  PINFCONTEXT ContextIn,
  [out] PINFCONTEXT ContextOut
);

Parameter

[in] ContextIn

Zeiger auf den INF-Dateikontext, der durch einen Aufruf der SetupFindFirstLine-Funktion abgerufen wird.

[out] ContextOut

Zeiger auf eine Variable, in der diese Funktion den Kontext der gefundenen Zeile zurückgibt. ContextOut kann auf ContextIn verweisen, wenn der Aufrufer dies wünscht.

Rückgabewert

Wenn diese Funktion die nächste Zeile findet, ist der Rückgabewert ein Nonzero-Wert. Andernfalls ist der Rückgabewert 0. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn ContextIn.Line auf mehrere INF-Dateien verweist, die mithilfe von SetupOpenAppendInfFile zusammen angefügt wurden, durchsucht diese Funktion den angegebenen Abschnitt in allen Dateien, auf die vom HINF verwiesen wird, um die nächste Zeile zu suchen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	setupapi.h
Bibliothek	Setupapi.lib
DLL	Setupapi.dll
APIs	ext-ms-win-setupapi-inf-l1-1-0 (in Windows 8 eingeführt)