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

Статья
11/20/2024

[Эта функция доступна для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. 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

Необязательный указатель на контекст строки в разделе копирование файлов, для которого требуется получить размер. Если InfContextNULL, используется параметр FileName.

[in] FileName

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

[in] Section

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

[in, out] FileSize

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

[in] RoundingFactor

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

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

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

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

Замечания

Необходимо указать только один из необязательных параметров, InfContext, Имя файлаи раздел .

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupGetSourceFileLocation

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