다음을 통해 공유


Installer.ProvideComponent 메서드

Installer 개체의 ProvideComponent 메서드는 전체 구성 요소 경로를 반환하고 필요한 설치를 수행합니다. 필요한 경우 Installer 개체의 ProvideComponent 메서드는 원본을 묻는 메시지를 표시하고 기능에 대한 사용 횟수를 증분합니다.

구문

Installer.ProvideComponent(
  Product,
  Feature,
  Component,
  InstallMode
)

매개 변수

제품

제품의 제품 코드를 지정합니다.

기능

구성 요소가 포함된 기능의 기능 ID를 지정합니다.

구성 요소

구성 요소 코드를 지정합니다.

InstallMode

설치 모드를 정의합니다. 이 매개 변수는 다음 테이블에 있는 값 중 하나일 수 있습니다.

Name 의미
msiInstallModeDefault
0
필요한 경우 설치를 수행하는 구성 요소 경로를 제공합니다.
msiInstallModeExisting
–1
기능이 있는 경우에만 구성 요소 경로를 제공합니다. 그렇지 않으면 빈 문자열을 반환합니다. 이 모드는 구성 요소의 키 파일이 있는지 확인합니다.
msiInstallModeNoDetection
–2
기능이 있는 경우에만 구성 요소 경로를 제공합니다. 그렇지 않으면 빈 문자열을 반환합니다. 이 모드는 구성 요소의 등록을 확인하지만 구성 요소의 키 파일이 있는지는 확인하지 않습니다.
msiInstallModeNoSourceResolution
–3
기능이 msiInstallStateLocal의 InstallState 매개 변수와 함께 있는 경우에만 구성 요소 경로를 제공합니다. 구성 요소의 등록을 확인하지만 구성 요소의 키 파일이 있는지는 확인하지 않습니다.
msiReinstallMode 플래그의 조합
ReinstallFeature를 호출하여 ReinstallMode 매개 변수에 이 매개 변수를 사용하여 기능을 다시 설치한 다음, 구성 요소를 제공합니다.

 

반환 값

이 메서드는 값을 반환하지 않습니다.

설명

ProvideComponent 메서드는 UseFeature, ConfigureFeatureComponentPath의 기능을 결합합니다. ProvideComponent 메서드는 호출 시퀀스를 간소화하지만 사용 횟수도 증가하므로 부정확한 사용 횟수를 방지하기 위해 주의해서 사용해야 합니다. 또한 ProvideComponent 메서드는 앞에서 언급한 메서드 및 속성에 대한 일련의 개별 호출보다 유연성이 떨어집니다.

애플리케이션이 예기치 않은 상황에서 복구하는 경우 애플리케이션은 이미 UseFeature를 호출하고 사용 횟수를 증가시켰을 수 있습니다. 이 경우 애플리케이션은 ProvideComponent 메서드 대신 ConfigureFeature 메서드를 호출하여 사용 횟수가 증가하지 않도록 해야 합니다.

msiInstallModeExisting 옵션은 msiReinstallMode 플래그와 함께 사용할 수 없습니다.

요구 사항

요구 사항
버전
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_IInstaller는 000C1090-0000-0000-C000-000000000046으로 정의됩니다.

추가 정보

MsiProvideComponent