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

Статья
11/20/2024

Функция 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 возвращает следующие значения:

Замечания

См. вызов функций базы данных из программ.

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

Заметка

Заголовок 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
целевая платформа	Виндоус
заголовка	msiquery.h
библиотеки	Msi.lib
DLL	Msi.dll

См. также

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

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

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