SetupFindFirstLineA-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 zum Installieren von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Installationsprogrammen für Anwendungen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]

Die SetupFindFirstLine-Funktion sucht eine Zeile im angegebenen Abschnitt einer INF-Datei. Wenn der Key-ParameterNULL ist, gibt SetupFindFirstLine die erste Zeile des Abschnitts zurück.

Syntax

WINSETUPAPI BOOL SetupFindFirstLineA(
  [in]      HINF        InfHandle,
  [in]      PCSTR       Section,
  [in]      PCSTR       Key,
  [in, out] PINFCONTEXT Context
);

Parameter

[in] InfHandle

Handle für die abzufragende INF-Datei.

[in] Section

Zeiger auf eine NULL-endende Zeichenfolge, die den Abschnitt der zu durchsuchenden INF-Dateien angibt.

[in] Key

Optionaler Zeiger auf eine NULL-endende Zeichenfolge, die den Schlüssel angibt, nach dem innerhalb des Abschnitts gesucht werden soll. Die NULL-Zeichenfolge darf die Größe des Zielpuffers nicht überschreiten. Dieser Parameter kann NULL sein. Wenn KeyNULL ist, wird die erste Zeile im Abschnitt zurückgegeben.

[in, out] Context

Zeiger auf eine Struktur, die die Kontextinformationen empfängt, die intern vom INF-Handle verwendet werden. Anwendungen dürfen in dieser Struktur keine Werte überschreiben.

Rückgabewert

Wenn die Funktion keine Zeile finden konnte, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn der InfHandle-Parameter auf mehrere INF-Dateien verweist, die mithilfe von SetupOpenAppendInfFile zusammen angefügt wurden, durchsucht die SetupFindFirstLine-Funktion den angegebenen Abschnitt in allen Dateien, auf die vom angegebenen HINF verwiesen wird.

Hinweis

Der Setupapi.h-Header definiert SetupFindFirstLine 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
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)