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

Статья
11/20/2024

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

Функция setupSetPlatformPathOverride используется для задания переопределения пути платформы для целевого компьютера при работе с INFs с другого компьютера. Таким образом, он может ссылаться на другую платформу, отличную от текущей работы. Для работы с источниками мультимедиа он может ссылаться на платформы, которые больше не поддерживаются, такие как Альфа, MIPS и PPC. Он удаляет переопределение пути платформы, если он не указан.

Синтаксис

WINSETUPAPI BOOL SetupSetPlatformPathOverrideW(
  [in] PCWSTR Override
);

Параметры

[in] Override

Указатель на строку null-terminated, содержащую сведения о платформе замены. Например, "альфа" или "x86". Этот параметр может быть null.

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

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

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

Если GetLastError возвращает ERROR_NOT_ENOUGH_MEMORY, SetupSetPlatformPathOverride не удалось сохранить строку Override.

Замечания

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

Например, рассмотрим компьютер с платформой MIPS, где платформа была задана как Альфа, вызовом SetPlatformPathOverride. После переопределения пути платформы операция копирования файлов помещается в очередь с исходным путем \pop\top\baz\mips\x.exe, the path will be changed to \pop\top\baz\alpha\x.exe.

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

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupSetDirectoryId

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