SetupEnumInfSectionsA-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 SetupEnumInfSections-Funktion ruft Abschnittsnamen aus einer INF-Datei ab.

Syntax

WINSETUPAPI BOOL SetupEnumInfSectionsA(
  [in]            HINF InfHandle,
  [in]            UINT Index,
  [out, optional] PSTR Buffer,
  [in]            UINT Size,
  [out, optional] UINT *SizeNeeded
);

Parameter

[in] InfHandle

Handle für die abzufragte INF-Datei.

[in] Index

Der nullbasierte Index des abzurufenden Abschnittsnamens. Dieser Index entspricht möglicherweise nicht der Reihenfolge der Abschnitte, wie sie in der INF-Datei angezeigt werden.

[out, optional] Buffer

Zeiger auf einen Puffer, der den Abschnittsnamen empfängt. Sie können die Funktion einmal aufrufen, um die erforderliche Puffergröße abzurufen, den erforderlichen Arbeitsspeicher zuzuweisen und die Funktion dann ein zweites Mal aufzurufen, um den Namen abzurufen. Mit diesem Verfahren können Sie Fehler vermeiden, die durch eine unzureichende Puffergröße verursacht werden. Dieser Parameter ist optional. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

[in] Size

Größe des Puffers, auf den returnBuffer in Zeichen verweist. Diese Zahl enthält das endende NULL-Zeichen .

[out, optional] SizeNeeded

Zeiger auf eine Position, die die erforderliche Größe des Puffers empfängt, auf den returnBuffer verweist. Die Größe wird als Anzahl von Zeichen angegeben, die zum Speichern des Abschnittsnamens erforderlich sind, einschließlich des abschließenden NULL-Zeichens.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

GetLastError gibt ERROR_NO_MORE_ITEMS zurück, wenn der Wert von EnumerationIndex größer oder gleich der Anzahl von Abschnittsnamen in der INF-Datei ist.

Hinweise

Diese Funktion kann alle eindeutigen Abschnittsnamen in der INF-Datei aufzählen. Wenn ein Abschnittsname in einer INF-Datei mehrmals angezeigt wird, gibt die Funktion den Namen nur einmal mithilfe eines einzelnen Enumerationsindexes zurück. Um alle Abschnittsnamen in der INF-Datei zurückzugeben, rufen Sie die Funktion auf, beginnend mit einem Enumerationsindex von null, und führen Sie dann wiederholte Aufrufe an die Funktion aus, während der Index erhöht wird, bis die Funktion FALSE zurückgibt und GetLastErrorERROR_NO_MORE_ITEMS zurückgibt. Ihre Anwendung sollte sich nicht darauf verlassen, dass die Abschnittsnamen basierend auf dem Enumerationsindex in beliebiger Reihenfolge zurückgegeben werden.

Hinweis

Der Setupapi.h-Header definiert SetupEnumInfSections 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-1 (eingeführt in Windows 10, Version 10.0.14393)

Share via