SetupFindFirstLineA-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 SetupFindFirstLine--Funktion sucht eine Zeile im angegebenen Abschnitt einer INF-Datei. Wenn der parameter KeyNULList, 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
Behandeln Sie die INF-Datei, die abgefragt werden soll.
[in] Section
Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die den Abschnitt der INF-Dateien angibt, in der gesucht werden soll.
[in] Key
Optionaler Zeiger auf eine NULL--terminated-Zeichenfolge, die den Schlüssel angibt, nach dem im Abschnitt gesucht werden soll. Die null-terminated string sollte die Größe des Zielpuffers nicht überschreiten. Dieser Parameter kann NULL-sein. Wenn Key-NULL-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 werte in dieser Struktur nicht überschreiben.
Rückgabewert
Wenn die Funktion keine Zeile finden konnte, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Wenn der InfHandle Parameter auf mehrere INF-Dateien verweist, die mithilfe SetupOpenAppendInfFile-angefügt wurden, durchsucht die SetupFindFirstLine--Funktion den angegebenen Abschnitt in allen Dateien, auf die durch den angegebenen HINF verwiesen wird.
Anmerkung
Der Header setupapi.h 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 |
|---|---|
| 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) |