Функция SetupGetIntField (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupGetIntField извлекает целочисленное значение из указанного поля строки в INF-файле.
Синтаксис
WINSETUPAPI BOOL SetupGetIntField(
[in] PINFCONTEXT Context,
[in] DWORD FieldIndex,
[out] PINT IntegerValue
);
Параметры
[in] Context
Указатель на контекст строки в INF-файле.
[in] FieldIndex
1-й индекс поля в указанной строке, из которой должно быть извлечено целое число.
FieldIndex 0 можно использовать для получения целочисленного ключа (например, рассмотрим следующую строку INF: 431 = 1, 2, 4. Значение 431 будет помещено в переменную, на которую указывает IntegerValue, если метод SetupGetIntField был вызван с fieldIndex 0).
[out] IntegerValue
Указатель на переменную, получающую целое число. Если поле не является целым числом, функция завершается сбоем и вызов GetLastError возвращает ERROR_INVALID_DATA.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ненулевым.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Целочисленное поле может начинаться с положительного (+) или отрицательного знака (-). Он будет интерпретироваться как десятичное число, если в файле нет префикса 0x или 0X, в этом случае это шестнадцатеричное значение.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | setupapi.h |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |
| Набор API | ext-ms-win-setupapi-inf-l1-1-1 (появилось в Windows 10 версии 10.0.14393) |