Функция SetupQueueCopySectionA (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция установки SetupQueueCopySection помещает все файлы в раздел INF-файла в очередь установки для копирования. Раздел должен находиться в правильном формате копировать файлы, а INF-файл должен содержать sourceDisksFiles и SourceDisksNames (или добавить INF-файлы, содержащие эти разделы).
Синтаксис
WINSETUPAPI BOOL SetupQueueCopySectionA(
[in] HSPFILEQ QueueHandle,
[in] PCSTR SourceRootPath,
[in] HINF InfHandle,
[in] HINF ListInfHandle,
[in] PCSTR Section,
[in] DWORD CopyStyle
);
Параметры
[in] QueueHandle
Обработайте очередь файла установки, как возвращается SetupOpenFileQueue.
[in] SourceRootPath
Указатель на строку, завершающуюся значением NULL, которая указывает корень источника для этой копии, например A:.
[in] InfHandle
Обработайте открытый INF-файл, содержащий разделы SourceDisksFiles и SourceDisksNames. Если ListInfHandle не указано, InfHandle содержит имена разделов. Если для системы пользователя существуют разделы для конкретной платформы (например, SourceDisksNames.x86 и SourceDisksFiles.x86), будет использоваться раздел, зависящий от платформы.
[in] ListInfHandle
Необязательный дескриптор открытого INF-файла, содержащего раздел для копирования. Если ListInfHandle не указано, предполагается, что InfHandle содержит раздел.
[in] Section
Указатель на строку, завершающуюся значением NULL, которая указывает имя раздела для копирования.
[in] CopyStyle
Флаги, управляющие поведением операции копирования файлов. Эти флаги могут быть сочетанием следующих значений.
SP_COPY_DELETESOURCE
Удалите исходный файл после успешной копии. Вызывающий объект не уведомляется, если удаление завершается ошибкой.
SP_COPY_REPLACEONLY
Скопируйте файл только в том случае, если это приведет к перезаписи файла в пути назначения.
SP_COPY_NEWER_OR_SAME
Просмотрите каждый файл, копируемый, чтобы узнать, совпадают ли ресурсы версии в версии или не более новой, чем существующую копию в целевом объекте.
Сведения о версии файла, используемые во время проверок версий, указываются в dwFileVersionMS и dwFileVersionLS членов структуры VS_FIXEDFILEINFO, как указано в функциях версии. Если у одного из файлов нет ресурсов версии или если они имеют идентичные сведения о версии, исходный файл считается более новым.
Если исходный файл не равен версии или более поздней версии, а указана CopyMsgHandler, вызывающий объект уведомляется и может отменить копию. Если CopyMsgHandler не указан, файл не копируется.
SP_COPY_NEWER_ONLY
Проверьте каждый файл, копируемый, чтобы узнать, являются ли его ресурсы версии более новой, чем существующую копию в целевом объекте. Если исходный файл является более новым, но не равен в версии существующего целевого объекта, файл копируется.
SP_COPY_NOOVERWRITE
Проверьте, существует ли целевой файл, и, если да, уведомите вызывающего абонента, который может ветоить копию. Если CopyMsgHandler не указан, файл не перезаписывается.
SP_COPY_NODECOMP
Не распаковывайте файл. Если этот флаг задан, целевой файл не получает несжатую форму исходного имени (при необходимости). Например, копирование f:\x86s\cmd.ex_ в \install\temp приводит к целевому файлу \install\temp\cmd.ex_. Если флаг SP_COPY_NODECOMP не указан, файл будет распаковлен, а целевой объект будет вызываться \install\temp\cmd.exe. Часть имени файла DestinationName, если указано, удаляется и заменяется именем файла исходного файла. При указании SP_COPY_NODECOMP нет сведений о языке или версии.
SP_COPY_LANGUAGEAWARE
Изучите каждый файл, копируемый, чтобы узнать, отличается ли его язык от языка любого существующего файла, уже размещенного в целевом объекте. Если это так, и указана CopyMsgHandler, вызывающий объект уведомляется и может отменить копию. Если CopyMsgHandler не указан, файл не копируется.
SP_COPY_SOURCE_ABSOLUTE
SourceFile — это полный путь к источнику. Не ищите его в разделе INF-файла SourceDisksNames.
SP_COPY_SOURCEPATH_ABSOLUTE
SourcePathRoot является полной частью исходного файла. Игнорируйте относительный источник, указанный в разделе SourceDisksNames INF-файла для исходного носителя, где находится файл. Этот флаг игнорируется, если указан SP_COPY_SOURCE_ABSOLUTE.
SP_COPY_FORCE_IN_USE
Если целевой объект существует, ведет себя так, как будто он используется и помещается в очередь файла для копирования на следующую перезагрузку системы.
SP_COPY_IN_USE_NEEDS_REBOOT
Если файл использовался во время операции копирования, оповещайте пользователя о необходимости перезагрузки системы.
SP_COPY_NOSKIP
Не предоставляйте пользователю возможность пропускать файл.
SP_COPY_FORCE_NOOVERWRITE
Проверьте, существует ли целевой файл и, если да, файл не перезаписан. Вызывающий объект уведомляется.
SP_COPY_FORCE_NEWER
Просмотрите каждый файл, копируемый, чтобы узнать, являются ли его ресурсы версии (или метки времени для файлов, не являющихся изображениями), что это не более новая копия в целевом объекте. Если копируемый файл не является более новым, файл не копируется. Вызывающий объект уведомляется.
SP_COPY_WARNIFSKIP
Если пользователь пытается пропустить файл, предупредите их о том, что пропуск файла может повлиять на установку. (Используется для системных критически важных файлов.)
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение является ненулевое значение.
Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Если каталог UNC указан в качестве целевого каталога операции копирования файлов, необходимо убедиться, что он существует до фиксации очереди. Функции установки не проверяют наличие и не создают каталоги UNC. Если целевой каталог UNC не существует, копирование файла завершится ошибкой.
Для этой функции требуется INF-файл Windows. Некоторые старые форматы INF-файлов могут не поддерживаться.
Заметка
Заголовок setupapi.h определяет SetupQueueCopySection в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows XP [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2003 [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | setupapi.h |
| библиотеки |
Setupapi.lib |
| DLL | Setupapi.dll |
См. также
Обзор