SetupFindNextMatchLineA-Funktion (setupapi.h)

Artikel
03/04/2024

[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)