Session.FeatureValidStates 속성

Session 개체의 FeatureValidStates 속성은 지정된 기능에 대한 유효한 설치 상태를 나타내는 각 관련 비트가 있는 비트 플래그를 나타내는 정수를 반환합니다.

이 속성은 읽기 전용입니다.

구문

propVal = Session.FeatureValidStates

속성 값

유효한 설치 상태를 검색할 기능 항목의 필수 문자열 이름입니다.

설명

반환 값은 다음과 같이 비트 플래그로 구성됩니다. 비트 0: 설정된 경우 로컬이 유효한 상태입니다. 비트 1: 설정된 경우 원본은 유효한 상태입니다.

FeatureValidStates 속성은 설치 관리자가 CostInitializeCostFinalize 작업을 호출한 후에만 성공합니다.

FeatureValidStates는 구성 요소의 현재 설치된 상태를 고려하지 않고 지정된 기능에 연결된 모든 구성 요소를 쿼리하여 상태 유효성을 결정합니다.

기능에 유효한 상태는 다음과 같이 결정됩니다.

  • 기능에 구성 요소가 없는 경우 INSTALLSTATE_LOCAL 및 INSTALLSTATE_SOURCE 모두 기능에 유효한 상태입니다.
  • 기능의 구성 요소 하나 이상에 msidbComponentAttributesLocalOnly 또는 msidbComponentAttributesOptional 특성이 있는 경우 INSTALLSTATE_LOCAL이 기능에 유효한 상태입니다.
  • 기능의 구성 요소 하나 이상에 msidbComponentAttributesSourceOnly 또는 msidbComponentAttributesOptional 특성이 있는 경우 INSTALLSTATE_SOURCE가 기능에 유효한 상태입니다.
  • 기능에 속한 구성 요소의 파일이 패치되거나 압축된 원본에서 제공되는 경우 INSTALLSTATE_SOURCE는 기능에 대한 유효한 상태로 포함되지 않습니다.
  • INSTALLSTATE_ADVERTISE는 기능이 보급 알림(msidbFeatureAttributesDisallowAdvertise)을 허용하지 않거나 기능에 보급 알림에 대한 플랫폼 지원(msidbFeatureAttributesNoUnsupportedAdvertise)이 필요하고 플랫폼에서 이를 지원하지 않는 경우 유효한 상태가 아닙니다.
  • INSTALLSTATE_ABSENT는 특성에 msidbFeatureAttributesUIDisallowAbsent가 포함되지 않은 경우 기능에 유효한 상태입니다.
  • 부모 기능을 따르도록 표시된 자식 기능(msidbFeatureAttributesFollowParent)에 대한 유효한 상태는 부모 기능의 작업 또는 설치된 상태를 기반으로 합니다.

속성이 실패하면 LastErrorRecord 메서드를 사용하여 확장된 오류 정보를 가져올 수 있습니다.

요구 사항

요구 사항
버전
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
DLL
Msi.dll
IID
IID_ISession 000C109E-0000-0000-C000-000000000046으로 정의됩니다.