Функция SetupFindNextMatchLineW (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupFindNextMatchLine возвращает расположение следующей строки в INF-файле относительно ContextIn.Line , соответствующего указанному ключу.
Синтаксис
WINSETUPAPI BOOL SetupFindNextMatchLineW(
[in] PINFCONTEXT ContextIn,
[in] PCWSTR 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) |