Функция SetupFindNextMatchLineA (setupapi.h)

Статья
11/20/2024

[Эта функция доступна для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. 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. Этот параметр может иметь значение NULL. Если ключ не указан, функция SetupFindNextMatchLine эквивалентна функции SetupFindNextLine.

[in, out] ContextOut

Указатель на переменную, в которой эта функция возвращает контекст найденной строки. ContextOut может указывать на ContextIn, если вызывающий объект хочет.

Возвращаемое значение

Функция возвращает ненулевое значение, если он находит соответствующую строку. В противном случае возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Если ContextIn.Inf ссылается на несколько INF-файлов, добавленных вместе с помощью SetupOpenAppendInfFile, функция SetupFindNextMatchLine выполняет поиск по указанному разделу во всех файлах, на которые ссылается HINF, чтобы найти следующую строку сопоставления.

Заметка

Заголовок setupapi.h определяет SetupFindNextMatchLine в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	setupapi.h
библиотеки	Setupapi.lib
DLL	Setupapi.dll
набор API	ext-ms-win-setupapi-inf-l1-1-0 (представлено в Windows 8)

См. также

Обзор

Поделиться через