Функция MsiGetFeatureStateA (msiquery.h)

Статья
08/25/2023

Функция MsiGetFeatureState получает запрошенное состояние компонента.

Синтаксис

UINT MsiGetFeatureStateA(
  [in]  MSIHANDLE    hInstall,
  [in]  LPCSTR       szFeature,
  [out] INSTALLSTATE *piInstalled,
  [out] INSTALLSTATE *piAction
);

Параметры

[in] hInstall

Дескриптор установки, предоставленной пользовательскому действию DLL или полученной через MsiOpenPackage, MsiOpenPackageEx или MsiOpenProduct.

[in] szFeature

Указывает имя компонента в продукте.

[out] piInstalled

Указывает возвращенное текущее состояние установки. Этот параметр не должен иметь значение null. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
INSTALLSTATE_BADCONFIG	Данные конфигурации повреждены.
INSTALLSTATE_INCOMPLETE	Установка приостановлена или выполняется.
INSTALLSTATE_SOURCEABSENT	Компонент должен запускаться из источника, и источник недоступен.
INSTALLSTATE_MOREDATA	Буфер возврата заполнен.
INSTALLSTATE_INVALIDARG	В функцию передан недопустимый параметр.
INSTALLSTATE_UNKNOWN	Указан нераспознанный продукт или компонент.
INSTALLSTATE_BROKEN	Функция не работает.
INSTALLSTATE_ADVERTISED	Объявленная функция.
INSTALLSTATE_ABSENT	Эта функция была удалена.
INSTALLSTATE_LOCAL	Компонент был установлен на локальном диске.
INSTALLSTATE_SOURCE	Компонент должен запускаться из источника, компакт-диска или сети.
INSTALLSTATE_DEFAULT	Компонент устанавливается в расположении по умолчанию: локальном или исходном.

[out] piAction

Получает действие, выполненное во время сеанса установки. Этот параметр не должен иметь значение null. Возвращаемые значения см. в разделе piInstalled.

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

Функция MsiGetFeatureState возвращает следующие значения:

Заголовок msiquery.h определяет MsiGetFeatureState в качестве псевдонима, который автоматически выбирает версию 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
Header	msiquery.h
Библиотека	Msi.lib
DLL	Msi.dll

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

Функции выбора установщика

Передача null в качестве аргумента функций установщика Windows

Share via