SetupEnumInfSectionsW-Funktion (setupapi.h)

Artikel
08/26/2023

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

Die SetupEnumInfSections-Funktion ruft Abschnittsnamen aus einer INF-Datei ab.

Syntax

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

Parameter

[in] InfHandle

Behandeln Sie 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 beendende 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 die Anzahl von Zeichen angegeben, die zum Speichern des Abschnittsnamens erforderlich sind, einschließlich des beendenden 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 auflisten. Wenn ein Abschnittsname mehr als einmal in einer INF-Datei angezeigt wird, gibt die Funktion den Namen nur einmal mit einem 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 aus, während sie den Index inkrementieren, bis die Funktion FALSE und GetLastErrorERROR_NO_MORE_ITEMS zurückgibt. Ihre Anwendung sollte sich nicht auf die zurückgegebenen Abschnittsnamen basierend auf dem Enumerationsindex in beliebiger Reihenfolge verlassen.

Hinweis

Der setupapi.h-Header 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 nicht codierungsneutralem Code 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