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

Статья
11/20/2024

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

Функция setupQueueRename помещает отдельную операцию переименования файла в очередь файла установки.

Синтаксис

WINSETUPAPI BOOL SetupQueueRenameW(
  [in] HSPFILEQ QueueHandle,
  [in] PCWSTR   SourcePath,
  [in] PCWSTR   SourceFilename,
  [in] PCWSTR   TargetPath,
  [in] PCWSTR   TargetFilename
);

Параметры

[in] QueueHandle

Обработайте очередь файла установки, как возвращается SetupOpenFileQueue.

[in] SourcePath

Указатель на строку, завершающуюся значением NULL, которая указывает исходный путь к файлу, который необходимо переименовать. Если SourceFileName не указано, SourcePath считается полным путем.

[in] SourceFilename

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

[in] TargetPath

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

[in] TargetFilename

Указатель на строку, завершающую значение NULL, которая задает новое имя исходного файла.

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

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

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

Замечания

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

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupQueueCopy

SetupQueueDelete

SetupQueueRenameSection

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