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

Статья
11/20/2024

Функция MsiSetComponentState задает компонент запрошенным состоянием.

Синтаксис

UINT MsiSetComponentStateA(
  [in] MSIHANDLE    hInstall,
  [in] LPCSTR       szComponent,
  [in] INSTALLSTATE iState
);

Параметры

[in] hInstall

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

[in] szComponent

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

[in] iState

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

Ценность	Значение
INSTALLSTATE_ABSENT	Компонент был удален.
INSTALLSTATE_LOCAL	Компонент был установлен на локальном диске.
INSTALLSTATE_SOURCE	Компонент будет выполняться из источника, CD или сети.

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

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

Замечания

Функция MsiSetComponentState запрашивает изменение состояния действия записи в таблице компонентов.

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

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

Заметка

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

См. также

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

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