SetupFindNextMatchLineA-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.]
Die SetupFindNextMatchLine-Funktion gibt den Speicherort der nächsten Zeile in einer INF-Datei relativ zu ContextIn.Line zurück, die einem angegebenen Schlüssel entspricht.
Syntax
WINSETUPAPI BOOL SetupFindNextMatchLineA(
[in] PINFCONTEXT ContextIn,
[in] PCSTR Key,
[in, out] PINFCONTEXT ContextOut
);
Parameter
[in] ContextIn
Zeiger auf einen INF-Dateikontext, der durch einen Aufruf der SetupFindFirstLine-Funktion abgerufen wird.
[in] Key
Wenn dieser optionale Parameter angegeben ist, wird ein Schlüssel bereitgestellt, der übereinstimmen soll. Bei diesem Parameter sollte es sich um eine NULL-beendete Zeichenfolge handeln. Dieser Parameter kann NULL sein. Wenn Key nicht angegeben ist, entspricht die SetupFindNextMatchLine-Funktion der SetupFindNextLine-Funktion .
[in, 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
Die Funktion gibt einen ungleichen Wert zurück, wenn sie eine übereinstimmende Zeile findet. Andernfalls ist der Rückgabewert 0. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Wenn ContextIn.Inf auf mehrere INF-Dateien verweist, die mithilfe von SetupOpenAppendInfFile zusammen angefügt wurden, durchsucht die SetupFindNextMatchLine-Funktion den angegebenen Abschnitt in allen Dateien, auf die vom HINF verwiesen wird, um die nächste übereinstimmende Zeile zu suchen.
Hinweis
Der setupapi.h-Header definiert SetupFindNextMatchLine als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
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 (eingeführt in Windows 8) |