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

  • Статья

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

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

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

Синтаксис

UINT MsiIsProductElevatedA(
  [in]  LPCSTR 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

   
Минимальная версия клиента Установщик 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.
Целевая платформа Windows
Header msi.h
Библиотека Msi.lib
DLL Msi.dll

См. также раздел

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

Установка пакета с повышенными привилегиями для Администратор