Функция SetupQueueRenameW (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. 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
Указатель на строку с пустым завершением, указывающую новое имя исходного файла.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ненулевым.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Так как предполагается, что операции переименования выполняются на фиксированном носителе, пользователю не будет предложено при фиксации очереди.
Примечание
Заголовок setupapi.h определяет SetupQueueRename в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | setupapi.h |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |