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이 아니어야 합니다.

반환 값

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

발언

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

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

기능에 사용할 수 있는 유효한 상태는 다음과 같이 결정됩니다.

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

MsiGetFeatureValidStates(hProduct, "Feature1", &dwValidStates);