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