다음을 통해 공유

MsiSetFeatureAttributesA 함수(msiquery.h)

  • 아티클

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 Server 2012, Windows 8, Windows Server 2008 R2 또는 Windows 7의 Windows Installer 5.0. Windows Server 2008 또는 Windows Vista의 Windows Installer 4.0 또는 Windows Installer 4.5. Windows Server 2003 또는 Windows XP의 Windows Installer
대상 플랫폼 Windows
헤더 msiquery.h
라이브러리 Msi.lib
DLL Msi.dll