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

Siehe auch

Funktionen

Übersicht

SetupGetBinaryField

SetupGetMultiSzField

SetupGetStringField