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

Статья
11/20/2024

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

Функция SetupGetInfFileList возвращает список INF-файлов, расположенных в указанном вызывающем каталоге, в буфер, предоставленный вызовом.

Синтаксис

WINSETUPAPI BOOL SetupGetInfFileListW(
  [in]      PCWSTR DirectoryPath,
  [in]      DWORD  InfStyle,
  [in, out] PWSTR  ReturnBuffer,
  [in]      DWORD  ReturnBufferSize,
  [in, out] PDWORD RequiredSize
);

Параметры

[in] DirectoryPath

Необязательный указатель на строкуnull, содержащую путь к каталогу, в котором выполняется поиск. Если это значение равно NULL, используется %windir%\inf directory.

[in] InfStyle

Тип INF-файла для поиска. Может быть сочетание следующих флагов.

INF_STYLE_OLDNT

Устаревший формат INF-файла.

INF_STYLE_WIN4

Формат INF-файла Windows.

[in, out] ReturnBuffer

Если не null, указывает на буфер, в котором эта функция возвращает список всех INF-файлов требуемых стилей, найденных в указанном подкаталоге. Имена файлов null-endd, с дополнительным null в конце списка. Строка null-terminated не должна превышать размер целевого буфера. Вы можете вызвать функцию один раз, чтобы получить необходимый размер буфера, выделить необходимую память, а затем вызвать функцию во второй раз, чтобы получить данные. С помощью этого метода можно избежать ошибок из-за недостаточного размера буфера. Имена файлов не включают путь. См. раздел "Примечания".

[in] ReturnBufferSize

Размер буфера, на который указывает параметр ReturnBuffer, в символах. Это включает в себя null конца. Если ReturnBuffer не указан, ReturnBufferSize игнорируется.

[in, out] RequiredSize

Если не значение NULL, указывает на переменную, в которой эта функция возвращает требуемый размер буфера, на который указывает параметр ReturnBuffer, в символах. Это включает в себя null конца. Если указан ReturnBuffer, а необходимый размер превышает ReturnBufferSize, функция завершается ошибкой и вызовом GetLastError возвращается ERROR_INSUFFICIENT_BUFFER.

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

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

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

Замечания

Если эта функция вызывается с помощью ReturnBuffer NULL и ReturnBufferSize нуля, функция помещает размер буфера, необходимый для хранения указанных данных в переменную, на которую указывает RequiredSize. Если функция выполнена успешно, возвращаемое значение ненулевое значение. В противном случае возвращаемое значение равно нулю и расширенным сведениям об ошибке можно получить путем вызова GetLastError.

Если несколько стилей INF-файлов возвращаются этой функцией, стиль определенного INF-файла можно определить путем вызова функции SetupGetInfInformation

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupGetInfInformation

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