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

Статья
11/20/2024

[Эта функция доступна для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]

Функция SetupOpenAppendInfFile добавляет сведения в INF-файл в INF-файл, который ранее открыл SetupOpenInfFile.

Синтаксис

WINSETUPAPI BOOL SetupOpenAppendInfFileA(
  [in]      PCSTR FileName,
  [in]      HINF  InfHandle,
  [in, out] PUINT ErrorLine
);

Параметры

[in] FileName

Если не значение NULL, Имя_файла указывает на строку NULL-terminated, содержащую имя (и необязательно путь) открываемого INF-файла. Если имя файла не содержит символы разделителя путей, сначала выполняется поиск в каталоге %windir%\inf, а затем в каталоге \system32 %windir%\ system32. Если имя файла содержит символы разделителя путей, предполагается, что он является полной спецификацией пути, а дальнейшая обработка не выполняется. Если имя_файлаNULL, имя INF-файла извлекается из значения LayoutFile раздела версии в существующем INF-файле. Та же логика поиска применяется к имени файла, полученному из ключа LayoutFile.

[in] InfHandle

Существующий дескриптор INF, к которому будет добавлен этот INF-файл.

[in, out] ErrorLine

Необязательный указатель на переменную, в которую эта функция возвращает номер строки (на основе 1), в котором произошла ошибка при загрузке INF-файла. Это значение обычно надежно, только если GetLastError не возвращает ERROR_NOT_ENOUGH_MEMORY. Если происходит состояние вне памяти, ErrorLine может быть 0.

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

Если функция выполнена успешно, возвращаемое значение является ненулевое значение.

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

Если имя_файла не указано и в разделе версии существующего INF-файла не было значения LayoutFile, GetLastError возвращает ERROR_INVALID_DATA.

Замечания

Для этой функции требуется INF-файл Windows. Некоторые старые форматы INF-файлов могут не поддерживаться. В этом случае функция возвращает FALSE и GetLastError возвращает ERROR_INVALID_PARAMETER. Основная цель этой функции — объединить INF-файл с сведениями о расположении исходного файла, содержащимися в файле, указанном в записи LayoutFile раздела версии (как правило, LAYOUT). INF).

ERROR_WRONG_INF_STYLE также можно вернуть с помощью SetupOpenAppendInfFile, если INF-файл использует старый формат.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	setupapi.h
библиотеки	Setupapi.lib
DLL	Setupapi.dll

См. также

Функции

Обзор

SetupCloseInfFile

SetupOpenInfFile

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