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

Статья
11/20/2024

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

Функция setupQueryInfFileInformation возвращает имя INF-файла из структуры SP_INF_INFORMATION в буфер.

Синтаксис

WINSETUPAPI BOOL SetupQueryInfFileInformationA(
  [in]      PSP_INF_INFORMATION InfInformation,
  [in]      UINT                InfIndex,
  [in, out] PSTR                ReturnBuffer,
  [in]      DWORD               ReturnBufferSize,
  [in, out] PDWORD              RequiredSize
);

Параметры

[in] InfInformation

Указатель на структуру SP_INF_INFORMATION, возвращенную из вызова функции SetupGetInfInformation.

[in] InfIndex

Индекс полученного содержимого INF-файла. Этот индекс может находиться в диапазоне [0, InfInformation.InfCount). Это означает, что значения равны нулю, но не включают, InfInformation.InfCount допустимы.

[in, out] ReturnBuffer

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

[in] ReturnBufferSize

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

[in, out] RequiredSize

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

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

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

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

Замечания

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

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupGetInfInformation

SetupQueryInfVersionInformation

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