Функция MsiIsProductElevatedW (msi.h)

Статья
11/20/2024

Функция MsiIsProductElevated возвращает, управляется ли продукт. Только приложения, требующие повышенных привилегий для установки и установки с помощью рекламы, считаются управляемыми, что означает, что приложение, установленное на каждом компьютере, всегда считается управляемым.

Приложение, установленное для каждого пользователя, считается управляемым только в том случае, если оно объявляется локальным системным процессом, олицетворяющим пользователя. Дополнительные сведения см. в разделе Реклама приложения Per-User, которое будет установлено с повышенными привилегиями.

MsiIsProductElevated проверяет, принадлежит ли локальная система данным реестра продуктов. Функция не относится к политикам учетных записей, таким как AlwaysInstallElevated.

Синтаксис

UINT MsiIsProductElevatedW(
  [in]  LPCWSTR szProduct,
  [out] BOOL    *pfElevated
);

Параметры

[in] szProduct

Полный GUID кода продукта для продукта.

Этот параметр является обязательным и не может быть null или пуст.

[out] pfElevated

Указатель на boOL для результата.

Этот параметр не может быть значение NULL.

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

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

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

Возвращаемый код	Описание
ERROR_UNKNOWN_PRODUCT	В настоящее время продукт не известен.
ERROR_INVALID_PARAMETER	Недопустимый аргумент передается функции.
ERROR_BAD_CONFIGURATION	Недопустимые сведения о конфигурации продукта.
ERROR_FUNCTION_FAILED	Не удалось выполнить функцию.
ERROR_CALL_NOT_IMPLEMENTED	Функция недоступна для определенной платформы.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP. Сведения о минимальном пакете обновления Windows, требуемом версией установщика Windows, см. в разделе "Требования к установщику Windows Run-Time".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll

См. также

определение контекста установки

установка пакета с повышенными привилегиями для без администратора

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