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

Статья
03/15/2023

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

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

Синтаксис

WINSETUPAPI BOOL SetupGetSourceFileSizeA(
  [in]      HINF        InfHandle,
  [in]      PINFCONTEXT InfContext,
  [in]      PCSTR       FileName,
  [in]      PCSTR       Section,
  [in, out] PDWORD      FileSize,
  [in]      UINT        RoundingFactor
);

Параметры

[in] InfHandle

Обработка загруженного INF-файла, содержащего разделы SourceDisksNames и SourceDisksFiles . Если для системы пользователя существуют разделы, зависящие от платформы (например, SourceDisksNames.x86 и SourceDisksFiles.x86), будет использоваться раздел для конкретной платформы.

[in] InfContext

Необязательный указатель на контекст для строки в разделе "Файлы копирования ", размер которой требуется извлечь. Если infContext имеет значение NULL, используется параметр FileName .

[in] FileName

Необязательный указатель на строку со значением NULL, содержащую имя файла (без пути), для которого возвращается размер. Если этот параметр имеет значение NULL , а также InfContext, используется параметр Section .

[in] Section

Необязательный указатель на строку, завершающуюся значением NULL, содержащую имя раздела "Копировать файлы ". Если указан этот параметр, вычисляется общий размер всех файлов, перечисленных в разделе .

[in, out] FileSize

Указатель на переменную, которая получает размер указанных файлов в байтах.

[in] RoundingFactor

Необязательное значение для округления размеров файлов. Все размеры файлов округляются до числа, кратного этому числу, перед добавлением к общему размеру. Округление полезно для более точного определения пространства, которое файл будет занимать на заданном томе, так как позволяет вызывающему объекту округление файлов до кратного размера кластера. Округление не выполняется, если не указан параметр RoundingFactor .

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

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

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

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

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	setupapi.h
Библиотека	Setupapi.lib
DLL	Setupapi.dll

См. также

Функции

Обзор

SetupGetSourceFileLocation