Share via

MsiGetFeatureValidStatesA 함수(msiquery.h)

  • 아티클

MsiGetFeatureValidStates 함수는 유효한 설치 상태를 반환합니다.

구문

UINT MsiGetFeatureValidStatesA(
  [in]  MSIHANDLE hInstall,
  [in]  LPCSTR    szFeature,
  [out] LPDWORD   lpInstallStates
);

매개 변수

[in] hInstall

DLL 사용자 지정 작업에 제공되거나 MsiOpenPackage, MsiOpenPackageEx 또는 MsiOpenProduct를 통해 가져온 설치에 대한 핸들입니다.

[in] szFeature

기능 이름을 지정합니다.

[out] lpInstallStates

유효한 설치 상태를 보유할 위치를 받습니다. 각 유효한 설치 상태에 대해 설치 관리자는 pInstallState 를 다음 값의 조합으로 설정합니다. 이 매개 변수는 null이 아니어야 합니다.

10 진수 값 의미
2
INSTALLSTATE_ADVERTISED
 이 기능을 보급할 수 있습니다.
4
INSTALLSTATE_ABSENT
 기능이 없을 수 있습니다.
8
INSTALLSTATE_LOCAL
 이 기능은 로컬 드라이브에 설치할 수 있습니다.
16
INSTALLSTATE_SOURCE
 이 기능은 원본, CD-ROM 또는 네트워크에서 실행되도록 구성할 수 있습니다.
32
INSTALLSTATE_DEFAULT
 이 기능은 기본 위치(로컬 또는 원본)를 사용하도록 구성할 수 있습니다.

반환 값

MsiGetFeatureValidStates 함수는 다음 값을 반환합니다.

설명

프로그램에서 데이터베이스 함수 호출을 참조하세요.

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

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

  • 기능에 구성 요소가 없는 경우 INSTALLSTATE_LOCAL 및 INSTALLSTATE_SOURCE 모두 기능에 유효한 상태입니다.
  • 기능의 구성 요소 하나 이상에 msidbComponentAttributesLocalOnly 또는 msidbComponentAttributesOptional 특성이 있는 경우 INSTALLSTATE_LOCAL이 기능에 유효한 상태입니다.
  • 기능의 구성 요소 하나 이상에 msidbComponentAttributesSourceOnly 또는 msidbComponentAttributesOptional 특성이 있는 경우 INSTALLSTATE_SOURCE가 기능에 유효한 상태입니다.
  • 기능에 속한 구성 요소의 파일이 패치되거나 압축된 원본에서 패치된 경우 INSTALLSTATE_SOURCE 기능에 대한 유효한 상태로 포함되지 않습니다.
  • INSTALLSTATE_ADVERTISE는 기능이 보급 알림(msidbFeatureAttributesDisallowAdvertise)을 허용하지 않거나 기능에 보급 알림에 대한 플랫폼 지원(msidbFeatureAttributesNoUnsupportedAdvertise)이 필요하고 플랫폼에서 이를 지원하지 않는 경우 유효한 상태가 아닙니다.
  • INSTALLSTATE_ABSENT는 특성에 msidbFeatureAttributesUIDisallowAbsent가 포함되지 않은 경우 기능에 유효한 상태입니다.
  • 부모 기능을 따르도록 표시된 자식 기능(msidbFeatureAttributesFollowParent)에 대한 유효한 상태는 부모 기능의 작업 또는 설치된 상태를 기반으로 합니다.
MsiGetFeatureValidStates를 호출한 후 조건문을 사용하여 기능의 유효한 설치 상태를 테스트할 수 있습니다. 예를 들어 MsiGetFeatureValidStates에 대한 다음 호출은 Feature1의 설치 상태를 가져옵니다. 
MsiGetFeatureValidStates(hProduct, "Feature1", &dwValidStates);

Feature1에 값 0(선호 로컬)의 특성이 있고 Feature1에 값 0(로컬에만 해당)의 특성이 있는 구성 요소가 하나 있는 경우 호출 후 dwValidStates 값은 14입니다. 이는 INSTALLSTATE_LOCAL, INSTALLSTATE_ABSENT 및 INSTALLSTATE_ADVERTISED Feature1에 유효한 상태임을 나타냅니다. 다음 조건문은 로컬이 이 기능에 유효한 상태인 경우 True로 평가됩니다.

( ( dwValidStates & ( 1 << INSTALLSTATE_LOCAL ) ) == ( 1 << INSTALLSTATE_LOCAL ) )

함수가 실패하면 MsiGetLastErrorRecord를 사용하여 확장된 오류 정보를 얻을 수 있습니다.

참고

msiquery.h 헤더는 MSiGetFeatureValidStates를 유니코드 전처리기 상수의 정의에 따라 이 함수의 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

추가 정보

설치 관리자 선택 함수

Null을 Windows Installer Functions의 인수로 전달