Функция SetupOpenAppendInfFileA (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupOpenAppendInfFile добавляет сведения из INF-файла в INF-файл, ранее открытый программой SetupOpenInfFile.
Синтаксис
WINSETUPAPI BOOL SetupOpenAppendInfFileA(
[in] PCSTR FileName,
[in] HINF InfHandle,
[in, out] PUINT ErrorLine
);
Параметры
[in] FileName
Если значение не равно NULL, FileName указывает на строку, завершающуюся значением NULL, содержащую имя (и при необходимости путь) открываемого INF-файла. Если имя файла не содержит символов разделителя пути, поиск выполняется сначала в каталоге %windir%\inf, а затем в каталоге %windir%\system32. Если имя файла содержит символы разделителя пути, предполагается, что это полная спецификация пути, и дальнейшая обработка не выполняется. Если fileName имеет значение NULL, INF-имя файла извлекается из значения LayoutFile раздела Version в существующем INF-файле. Та же логика поиска применяется к имени файла, полученному из ключа LayoutFile.
[in] InfHandle
Существующий дескриптор INF, к которому будет добавлен этот INF-файл.
[in, out] ErrorLine
Необязательный указатель на переменную, в которую эта функция возвращает номер строки (на основе 1), в которой произошла ошибка во время загрузки INF-файла. Как правило, это значение является надежным, только если GetLastError не возвращает ERROR_NOT_ENOUGH_MEMORY. Если возникает проблема нехватки памяти, строка ошибки может иметь значение 0.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ненулевым.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Если FileName не было указано и в разделе Version существующего INF-файла не было значения LayoutFile, GetLastError возвращает ERROR_INVALID_DATA.
Комментарии
Для этой функции требуется INF-файл Windows. Некоторые старые форматы INF-файлов могут не поддерживаться. В этом случае функция возвращает значение FALSE , а GetLastError возвращает ERROR_INVALID_PARAMETER. Назначение этой функции main заключается в объединении INF-файла с информацией о расположении исходного файла, содержащейся в файле, указанном в записи LayoutFile раздела Версия (обычно это МАКЕТ. INF).
ERROR_WRONG_INF_STYLE также может быть возвращено программой SetupOpenAppendInfFile , если INF-файл использует более старый формат.
Примечание
Заголовок setupapi.h определяет SetupOpenAppendInfFile в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | setupapi.h |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |