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

Статья
11/20/2024

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

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

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

Синтаксис

WINSETUPAPI DWORD SetupDecompressOrCopyFileW(
  [in] PCWSTR SourceFileName,
  [in] PCWSTR TargetFileName,
  [in] PUINT  CompressionType
);

Параметры

[in] SourceFileName

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

[in] TargetFileName

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

[in] CompressionType

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

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

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

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

Замечания

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupGetFileCompressionInfo

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