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

Статья
11/20/2024

Функция MsiSetFeatureAttributes может изменять атрибуты компонента по умолчанию во время выполнения. Обратите внимание, что атрибуты функций по умолчанию создаются в столбце "Атрибуты" таблицы компонентов .

Синтаксис

UINT MsiSetFeatureAttributesA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szFeature,
  [in] DWORD     dwAttributes
);

Параметры

[in] hInstall

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

[in] szFeature

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

[in] dwAttributes

Атрибуты функций, указанные во время выполнения в качестве набора битовых флагов:

Постоянный	Значение
INSTALLFEATUREATTRIBUTE_FAVORLOCAL 1	Изменяет атрибуты компонентов по умолчанию на msidbFeatureAttributesFavorLocal во время выполнения. Дополнительные сведения см. в столбце "Атрибуты" таблицы компонентов .
INSTALLFEATUREATTRIBUTE_FAVORSOURCE 2	Изменяет атрибуты функций по умолчанию на msidbFeatureAttributesFavorSource во время выполнения. Дополнительные сведения см. в столбце "Атрибуты" таблицы компонентов .
INSTALLFEATUREATTRIBUTE_FOLLOWPARENT 4	Изменяет атрибуты функций по умолчанию на msidbFeatureAttributesFollowParent во время выполнения. Обратите внимание, что этот атрибут не является допустимым для функций верхнего уровня. Дополнительные сведения см. в столбце "Атрибуты" таблицы компонентов .
INSTALLFEATUREATTRIBUTE_FAVORADVERTISE 8	Изменяет атрибуты функций по умолчанию на msidbFeatureAttributesFavorAdvertise во время выполнения. Дополнительные сведения см. в столбце "Атрибуты" таблицы компонентов .
INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE 16	Изменяет атрибуты функций по умолчанию на msidbFeatureAttributesDisallowAdvertise во время выполнения. Дополнительные сведения см. в столбце "Атрибуты" таблицы компонентов .
INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE 32	Изменяет атрибуты функций по умолчанию на msidbFeatureAttributesNoUnsupportedAdvertise во время выполнения. Дополнительные сведения см. в столбце "Атрибуты" таблицы компонентов .

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

Эта функция возвращает UINT.

Замечания

msiSetFeatureAttributes необходимо вызывать после действия CostInitialize и перед действием CostFinalize. Функция возвращает ERROR_FUNCTION_FAILED при вызове в любое другое время.

Флаги INSTALLFEATUREATTRIBUTE_FAVORLOCAL, INSTALLFEATUREATTRIBUTE_FAVORSOURCE и INSTALLFEATUREATTRIBUTE_FOLLOWPARENT являются взаимоисключающими. Для любой функции можно задать только один из этих битов. Если задано несколько этих флагов, поведение этой функции не определено.

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

Заметка

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

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