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

Статья
08/26/2023

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

Функция SetupDecompressOrCopyFile копирует файл, при необходимости распаковывая его.

При копировании файла вызывающий объект этой функции должен иметь права на запись в целевой каталог.

Синтаксис

WINSETUPAPI DWORD SetupDecompressOrCopyFileA(
  [in] PCSTR SourceFileName,
  [in] PCSTR TargetFileName,
  [in] PUINT CompressionType
);

Параметры

[in] SourceFileName

Имя копируемых файлов. Следует использовать строку со значением NULL. Этот параметр может принимать значение NULL. Если CompressionType не указан и функция SetupDecompressOrCopyFile не находит файл, указанный в sourceFileName, функция выполняет поиск файла с двумя альтернативными именами в сжатой форме. Например, если файл F:\x86\cmd.exe и он не найден, функция ищет F:\x86\cmd.ex_ и, если он не найден, выполняется поиск F:\x86\cmd.ex$. Если параметр CompressionType указан, дополнительная обработка имени файла не выполняется; файл должен существовать точно так, как указано, иначе функция завершается ошибкой.

[in] TargetFileName

Точное имя целевого файла, который будет создан путем распаковки или копирования исходного файла. Следует использовать строку со значением NULL.

[in] CompressionType

Необязательный указатель на тип сжатия, используемый в исходном файле. Тип сжатия можно определить, вызвав SetupGetFileCompressionInfo. Если это значение равно FILE_COMPRESSION_NONE, файл копируется (не распаковывается) независимо от сжатия, используемого в источнике. Если CompressionType не указан, эта подпрограмма автоматически определяет тип сжатия.

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

Функция SetupDecompressOrCopyFile возвращает код системной ошибки , указывающий на результат операции.

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

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

Требования

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

См. также

Функции

Обзор

SetupGetFileCompressionInfo

Share via