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

Статья
20.11.2024

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

[in] Key

Необязательный указатель на строку null-terminated, указывающую ключ для поиска в разделе. Строка null-terminated не должна превышать размер целевого буфера. Этот параметр может быть NULL. Если ключNULL, возвращается первая строка раздела.

[in, out] Context

Указатель на структуру, которая получает сведения о контексте, используемые внутри дескриптором INF. Приложения не должны перезаписывать значения в этой структуре.

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

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

Замечания

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

Примечание

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

Требования

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