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

  • Статья

Функция 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
 Компонент будет выполняться из источника, компакт-диска или из сети.

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

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

Комментарии

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

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

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

Примечание

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

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

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