Функция SetupSetPlatformPathOverrideA (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupSetPlatformPathOverride используется для задания переопределения пути платформы для целевого компьютера при работе с INFs с другого компьютера. Таким образом, он может ссылаться на платформу, отличную от текущей. Для работы с источниками мультимедиа он может ссылаться на платформы, которые больше не поддерживаются, такие как Альфа, MIPS и PPC. Он удаляет переопределение пути платформы, если он не указан.
Синтаксис
WINSETUPAPI BOOL SetupSetPlatformPathOverrideA(
[in] PCSTR Override
);
Параметры
[in] Override
Указатель на строку, завершающуюся значением NULL, которая содержит сведения о платформе замены. Например, "alpha" или "x86". Этот параметр может иметь значение NULL.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ненулевым.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Если GetLastError возвращает ERROR_NOT_ENOUGH_MEMORY, setupSetPlatformPathOverride не удалось сохранить строку Переопределения .
Комментарии
SetPlatformPathOverride используется для изменения исходного пути при постановке файлов в очередь. Если переопределение пути платформы было задано путем вызова Метода SetPlatformPathOverride, любая функция установки, которая ставит в очередь операции копирования файлов, будет проверять конечный компонент исходного пути и, если последний компонент соответствует имени платформы пользователя, заменит его строкой переопределения, заданной SetPlatformPathOverride.
Например, рассмотрим компьютер с платформой MIPS, где для платформы задано значение Alpha путем вызова SetPlatformPathOverride. После задания переопределения пути платформы операция копирования файла помещается в очередь с исходным путем \pop\top\baz\mips\x.exe, путь будет изменен на \pop\top\baz\alpha\x.exe.
Пути к операциям копирования файлов, помещенные в очередь до задания переопределения пути, не изменяются.
Примечание
Заголовок setupapi.h определяет SetupSetPlatformPathOverride в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | setupapi.h |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |