SetupFindNextLine-Funktion (setupapi.h)
[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) |