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

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

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

Синтаксис

WINSETUPAPI BOOL SetupQueryInfFileInformationW(
  [in]      PSP_INF_INFORMATION InfInformation,
  [in]      UINT                InfIndex,
  [in, out] PWSTR               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. Строка, завершающаяся значением NULL, не должна превышать размер буфера назначения. Вы можете вызвать функцию один раз, чтобы получить требуемый размер буфера, выделить необходимую память, а затем вызвать функцию второй раз, чтобы получить данные. См. раздел «Примечания». С помощью этого метода можно избежать ошибок из-за недостаточного размера буфера. Этот параметр может принимать значение NULL.

[in] ReturnBufferSize

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

[in, out] RequiredSize

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

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

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

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

Комментарии

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

Требования

См. также

Функции

Обзор

SetupGetInfInformation

SetupQueryInfVersionInformation