SetupGetIntField-Funktion (setupapi.h)
[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 SetupGetIntField-Funktion ruft einen ganzzahligen Wert aus dem angegebenen Feld einer Zeile in einer INF-Datei ab.
Syntax
WINSETUPAPI BOOL SetupGetIntField(
[in] PINFCONTEXT Context,
[in] DWORD FieldIndex,
[out] PINT IntegerValue
);
Parameter
[in] Context
Zeiger auf den Kontext für eine Zeile in einer INF-Datei.
[in] FieldIndex
Der 1-basierte Index des Felds innerhalb der angegebenen Zeile, aus der die ganze Zahl abgerufen werden soll.
Ein FieldIndex von 0 kann verwendet werden, um einen ganzzahligen Schlüssel abzurufen (betrachten Sie beispielsweise die folgende INF-Zeile, 431 = 1, 2, 4. Der Wert 431 wird in die Variable eingefügt, auf die integerValue verweist, wenn SetupGetIntField mit einem FieldIndex von 0 aufgerufen wird.
[out] IntegerValue
Zeiger auf eine Variable, die die ganze Zahl empfängt. Wenn das Feld keine ganze Zahl ist, schlägt die Funktion fehl, und ein Aufruf von GetLastError gibt ERROR_INVALID_DATA zurück.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Das Ganzzahlfeld kann mit einem positiven (+) oder negativen (-) Zeichen beginnen. Sie wird als Dezimalzahl interpretiert, es sei denn, in der Datei wird das Präfix 0x oder 0X vorangestellt, in diesem Fall ist sie hexadezimal.
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) |