Функция SetupFindFirstLineA (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupFindFirstLine находит строку в указанном разделе INF-файла. Если параметр Key имеет значение NULL, SetupFindFirstLine возвращает первую строку раздела.
Синтаксис
WINSETUPAPI BOOL SetupFindFirstLineA(
[in] HINF InfHandle,
[in] PCSTR Section,
[in] PCSTR Key,
[in, out] PINFCONTEXT Context
);
Параметры
[in] InfHandle
Выполните запрос к INF-файлу.
[in] Section
Указатель на строку, заканчивающуюся null, указывающую раздел INF-файлов для поиска.
[in] Key
Необязательный указатель на строку, завершающуюся значением NULL, указывающую ключ для поиска в разделе. Строка, завершающаяся значением NULL, не должна превышать размер буфера назначения. Этот параметр может принимать значение NULL. Если параметр Key имеет значение NULL, возвращается первая строка раздела.
[in, out] Context
Указатель на структуру, которая получает сведения о контексте, используемые внутри дескриптором INF. Приложения не должны перезаписывать значения в этой структуре.
Возвращаемое значение
Если функции не удалось найти строку, возвращаемое значение равно нулю. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Если параметр InfHandle ссылается на несколько INF-файлов, которые были добавлены вместе с помощью SetupOpenAppendInfFile, функция SetupFindFirstLine выполняет поиск по указанному разделу во всех файлах, на которые ссылается указанный HINF.
Примечание
Заголовок setupapi.h определяет SetupFindFirstLine в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | setupapi.h |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |
| Набор API | ext-ms-win-setupapi-inf-l1-1-0 (появилось в Windows 8) |