Функция SetupSetPlatformPathOverrideW (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupSetPlatformPathOverride используется для задания переопределения пути платформы для целевого компьютера при работе с INF с другого компьютера. Таким образом, он может ссылаться на платформу, отличную от текущей. Для работы с источниками мультимедиа они могут относиться к платформам, которые больше не поддерживаются, например Alpha, MIPS и PPC. Он удаляет переопределение пути платформы, если он не указан.
Синтаксис
WINSETUPAPI BOOL SetupSetPlatformPathOverrideW(
[in] PCWSTR 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 |