SetupFindNextMatchLineA-Funktion (setupapi.h)
[Diese Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. 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 für die Installation 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, wie durch einen Aufruf der SetupFindFirstLine--Funktion abgerufen.
[in] Key
Wenn dieser optionale Parameter angegeben ist, stellt er einen schlüssel für die Übereinstimmung bereit. Dieser Parameter sollte eine mit Null beendete Zeichenfolge sein. 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 wünschen.
Rückgabewert
Die Funktion gibt einen Wert ungleich Null zurück, wenn eine übereinstimmende Zeile gefunden wird. Andernfalls ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Wenn ContextIn.Inf auf mehrere INF-Dateien verweist, die mithilfe SetupOpenAppendInfFile-angefügt wurden, durchsucht die SetupFindNextMatchLine Funktion in allen Dateien, auf die von der HINF verwiesen wird, um die nächste übereinstimmende Zeile zu finden.
Anmerkung
Der header setupapi.h 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 Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | setupapi.h |
| Library | Setupapi.lib |
| DLL- | Setupapi.dll |
| API-Satz | ext-ms-win-setupapi-inf-l1-1-0 (eingeführt in Windows 8) |