SetupOpenInfFileA-Funktion (setupapi.h)

Artikel
03/01/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 SetupOpenInfFile-Funktion öffnet eine INF-Datei und gibt ein Handle zurück.

Syntax

WINSETUPAPI HINF SetupOpenInfFileA(
  [in] PCSTR FileName,
  [in] PCSTR InfClass,
  [in] DWORD InfStyle,
  [in] PUINT ErrorLine
);

Parameter

[in] FileName

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen (und optionalen Pfad) der zu öffnenden INF-Datei enthält. Wenn der Dateiname keine Pfadtrennzeichen enthält, wird zuerst im Verzeichnis %windir%\inf und dann im Verzeichnis %windir%\system32 nach gesucht. Wenn der Dateiname Pfadtrennzeichen enthält, wird davon ausgegangen, dass es sich um eine vollständige Pfadspezifikation handelt, und es wird keine weitere Verarbeitung durchgeführt.

[in] InfClass

Optionaler Zeiger auf eine NULL-endende Zeichenfolge, die die klasse der gewünschten INF-Datei enthält. Diese Zeichenfolge muss mit dem Class-Wert des Abschnitts Version übereinstimmen (z. B. Class=Net). Wenn im Class-Wert kein Eintrag vorhanden ist, aber im Abschnitt Version ein Eintrag für ClassGUID vorhanden ist, wird der entsprechende Klassenname für diese GUID abgerufen und für den Vergleich verwendet.

[in] InfStyle

Format der ZU öffnenden oder zu suchenden INF-Datei. Dieser Parameter kann eine Kombination der folgenden Flags sein.

INF_STYLE_OLDNT

Ein älteres INF-Dateiformat.

INF_STYLE_WIN4

Ein Windows INF-Dateiformat.

[in] ErrorLine

Optionaler Zeiger auf eine Variable, an die diese Funktion die (1-basierte) Zeilennummer zurückgibt, bei der beim Laden der INF-Datei ein Fehler aufgetreten ist. Dieser Wert ist im Allgemeinen nur zuverlässig, wenn GetLastError keine ERROR_NOT_ENOUGH_MEMORY zurückgibt. Wenn eine Nicht-Arbeitsspeicher-Bedingung auftritt, kann ErrorLine 0 sein.

Rückgabewert

Die Funktion gibt bei erfolgreicher Ausführung ein Handle für die geöffnete INF-Datei zurück. Andernfalls wird der Rückgabewert INVALID_HANDLE_VALUE. Erweiterte Fehlerinformationen können durch einen Aufruf von GetLastError abgerufen werden.

Hinweise

Wenn beim Laden ein Fehler auftritt, weil der INF-Dateityp nicht mit InfClass übereinstimmt, gibt die Funktion INVALID_HANDLE_VALUE zurück, und ein Aufruf von GetLastError gibt ERROR_CLASS_MISMATCH zurück.

Wenn mehrere INF-Dateistile angegeben werden, kann der Stil der geöffneten INF-Datei durch Aufrufen der SetupGetInfInformation-Funktion bestimmt werden.

Da mehrere Klassen-GUID mit demselben Klassennamen vorhanden sein können, sollten Aufrufer, die an INF-Dateien einer bestimmten Klasse (d. h. einer bestimmten Klassen-GUID) interessiert sind, den ClassGUID-Wert aus der INF-Datei abrufen, indem Sie SetupQueryInfVersionInformation aufrufen.

Bei älteren INF-Dateien muss die InfClass-Zeichenfolge mit dem Typ übereinstimmen, der im OptionType-Wert des Abschnitts "Identification " in der INF-Datei angegeben ist (z. B. OptionType=NetAdapter).

Hinweis

Der Setupapi.h-Header definiert SetupOpenInfFile 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)