Функция SetupQueueRenameA (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupQueueRename помещает отдельную операцию переименования файла в очередь файлов установки.
Синтаксис
WINSETUPAPI BOOL SetupQueueRenameA(
[in] HSPFILEQ QueueHandle,
[in] PCSTR SourcePath,
[in] PCSTR SourceFilename,
[in] PCSTR TargetPath,
[in] PCSTR TargetFilename
);
Параметры
[in] QueueHandle
Дескриптор очереди файла установки, возвращенный setupOpenFileQueue.
[in] SourcePath
Указатель на строку, завершающуюся нулевым значением, которая указывает исходный путь к файлу для переименования. Если параметр SourceFileName не указан, предполагается, что sourcePath является полным путем.
[in] SourceFilename
Указатель на строку, завершающуюся значением NULL, которая указывает часть имени файла для переименования. Если значение не указано, sourcePath — это полный путь.
[in] TargetPath
Указатель на строку, завершающуюся нулевым значением, которая указывает целевой каталог. Если указан этот параметр, операция переименования фактически является операцией перемещения. Если параметр TargetPath не указан, файл переименовывается, но остается в текущем расположении.
[in] TargetFilename
Указатель на строку, завершающуюся нулевым значением, которая указывает новое имя исходного файла.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет ненулевым.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Так как предполагается, что операции переименования выполняются на фиксированном носителе, пользователь не будет запрашивать при фиксации очереди.
Примечание
Заголовок setupapi.h определяет SetupQueueRename в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | setupapi.h |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |