Функция SetupFindNextMatchLineA (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupFindNextMatchLine возвращает расположение следующей строки в INF-файле относительно ContextIn.Line , соответствующего указанному ключу.
Синтаксис
WINSETUPAPI BOOL SetupFindNextMatchLineA(
[in] PINFCONTEXT ContextIn,
[in] PCSTR Key,
[in, out] PINFCONTEXT ContextOut
);
Параметры
[in] ContextIn
Указатель на контекст INF-файла, полученный при вызове функции SetupFindFirstLine .
[in] Key
Если указан этот необязательный параметр, он предоставляет ключ для сопоставления. Этот параметр должен быть строкой, заканчивающейся нулевым значением. Этот параметр может иметь значение Null. Если параметр Key не указан, функция SetupFindNextMatchLine эквивалентна функции SetupFindNextLine .
[in, out] ContextOut
Указатель на переменную, в которой эта функция возвращает контекст найденной строки. ContextOut может указывать на ContextIn , если требуется вызывающий объект.
Возвращаемое значение
Функция возвращает ненулевое значение, если находит соответствующую строку. В противном случае возвращаемое значение равно нулю. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Если ContextIn.Inf ссылается на несколько INF-файлов, которые были добавлены вместе с помощью SetupOpenAppendInfFile, функция SetupFindNextMatchLine выполняет поиск по указанному разделу во всех файлах, на которые ссылается HINF, чтобы найти следующую соответствующую строку.
Примечание
Заголовок setupapi.h определяет SetupFindNextMatchLine в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | 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) |