SetupEnumInfSectionsA-Funktion (setupapi.h)

Artikel
11/20/2024

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

Behandeln Sie die INF-Datei, die abgefragt werden soll.

[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

Zeigen Sie 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 dann die Funktion ein zweites Mal aufzurufen, um den Namen abzurufen. Mit dieser Technik können Sie Fehler vermeiden, die durch eine unzureichende Puffergröße verursacht werden. Dieser Parameter ist optional. Weitere Informationen finden Sie im Abschnitt "Hinweise".

[in] Size

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

[out, optional] SizeNeeded

Zeiger auf eine Position, die die erforderliche Größe des Puffers empfängt, auf die durch ReturnBuffer-verwiesen wird. Die Größe wird als die Anzahl der Zeichen angegeben, die zum Speichern des Abschnittsnamens erforderlich sind, einschließlich des endenden NULL- Zeichens.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

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

Bemerkungen

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 Enumerationsindex zurück. Um alle Abschnittsnamen in der INF-Datei zurückzugeben, rufen Sie die Funktion ab einem Enumerationsindex von Null auf, und führen Sie dann wiederholte Aufrufe an die Funktion durch, während der Index erhöht wird, bis die Funktion FALSE- zurückgibt, und GetLastError gibt ERROR_NO_MORE_ITEMSzurück. Ihre Anwendung sollte nicht auf die Abschnittsnamen basieren, die basierend auf dem Enumerationsindex in beliebiger Reihenfolge zurückgegeben werden.

Anmerkung

Der header setupapi.h definiert SetupEnumInfSections als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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-1 (eingeführt in Windows 10, Version 10.0.14393)

Freigeben über