다음을 통해 공유


Installer 개체

COM이 설치 관리자 함수에 액세스하는 데 필요한 자동화 지원을 로드하려면 먼저 Installer 개체를 만들어야 합니다. 이 개체는 최상위 개체를 만들고 해당 메서드에 액세스하는 래퍼를 제공합니다.

ProgId "WindowsInstaller.Installer"에서 Installer 개체를 만들 수 있습니다.

멤버

Installer 개체에는 다음과 같은 유형의 멤버가 있습니다.

메서드

Installer 개체에는 다음과 같은 메서드가 있습니다.

메서드 설명
AddSource 원본 목록의 유효한 네트워크 원본 목록에 원본을 추가합니다.
AdvertiseProduct 설치 패키지를 보급합니다.
AdvertiseScript 설치 패키지를 보급합니다.
ApplyMultiplePatches 패치를 받을 수 있는 제품에 하나 이상의 패치를 적용합니다. PATCH 속성을 제공된 패치 패키지의 경로로 설정합니다.
ApplyPatch 패치 패키지에 의해 패치를 받을 수 있는 것으로 나열된 각 제품에 대해 설치를 호출하고 PATCH 속성을 패치 패키지의 경로로 설정합니다.
ClearSourceList 원본 목록에서 모든 네트워크 원본을 제거합니다.
CollectUserInfo 사용자 정보와 제품 코드를 모두 수집하고 저장하는 사용자 인터페이스 마법사 시퀀스를 호출합니다.
ConfigureFeature 제품 기능의 설치된 상태를 구성합니다.
ConfigureProduct 제품을 설치하거나 제거합니다.
CreateAdvertiseScript 보급 스크립트를 생성합니다.
CreateRecord 요청된 필드 수가 있는 새 Record 개체를 반환합니다.
EnableLog 현재 프로세스 공간의 모든 후속 설치 세션에 대해 선택한 메시지 유형을 로깅할 수 있습니다.
ExtractPatchXMLData 패치에서 정보를 XML 문자열로 추출합니다.
FileHash 파일에 대한 경로를 가져와 해당 파일의 128비트 해시를 반환합니다.
FileSignatureInfo 파일의 경로를 사용하고 해시 또는 인코딩된 인증서를 나타내는 바이트의 SAFEARRAY를 반환합니다.
FileSize 지정된 파일의 크기를 반환합니다.
FileVersion 지정된 경로의 버전 문자열 또는 언어 문자열을 반환합니다.
ForceSourceListResolution 이렇게 하면 다음에 원본이 필요할 때 설치 관리자가 원본 목록에서 유효한 제품 원본을 검색하도록 합니다.
InstallProduct 설치 관리자 패키지를 열고 설치 세션을 초기화합니다.
LastErrorRecord 오류 레코드를 생성한 함수의 최근 오류에 대한 오류 매개 변수가 포함된 Record 개체를 반환합니다.
OpenDatabase 기존 데이터베이스를 열거나 새 데이터베이스를 만듭니다.
OpenPackage 제품 데이터베이스에 액세스하고 엔진을 설치하는 함수와 함께 사용할 설치 관리자 패키지를 엽니다.
OpenProduct 제품 코드를 사용하여 설치된 제품에 대한 설치 관리자 패키지를 엽니다.
ProvideAssembly 어셈블리의 설치된 경로를 반환합니다.
ProvideComponent 전체 구성 요소 경로를 반환하고 필요한 설치를 수행합니다.
ProvideQualifiedComponent 전체 구성 요소 경로를 반환하고 필요한 설치를 수행합니다.
RegistryValue 값의 지정된 레지스트리 키에 대한 정보를 읽습니다.
ReinstallFeature 기능을 다시 설치하거나 설치된 기능의 문제를 수정합니다.
ReinstallProduct 제품을 다시 설치하거나 설치된 제품의 설치 문제를 수정합니다.
RemovePatches 패치를 받을 수 있는 제품에 대해 하나 이상의 패치를 제거합니다.
UseFeature 특정 기능에 대한 사용 횟수를 증분하고 해당 기능에 대한 설치 상태를 반환합니다.

 

속성

Installer 개체에는 다음과 같은 속성이 있습니다.

속성 액세스 유형 설명
ClientsEx
지정된 설치 구성 요소를 사용하는 제품을 나열하는 RecordList 개체를 반환합니다.
Windows Installer 4.5 이하: 지원되지 않습니다.
ComponentClients
지정된 구성 요소의 클라이언트 집합을 열거하는 StringList 개체를 반환합니다.
ComponentPath
설치된 구성 요소에 대한 전체 경로를 반환합니다.
ComponentPathEx
지정된 설치 구성 요소의 전체 경로를 제공하는 RecordList 개체를 반환합니다.
Windows Installer 4.5 이하: 지원되지 않습니다.
ComponentQualifiers
지정된 구성 요소에 대해 등록된 한정자 집합을 열거하는 StringList 개체를 반환합니다.
구성 요소
모든 제품에 대해 설치된 구성 요소 집합을 열거하는 StringList 개체를 반환합니다.
ComponentsEx
설치된 구성 요소를 나열하는 RecordList 개체를 반환합니다.
Windows Installer 4.5 이하: 지원되지 않습니다.
Environment
읽기/쓰기
현재 프로세스의 환경 변수에 대한 문자열 값입니다.
FeatureParent
기능의 부모 기능을 지정합니다.
기능
지정된 제품에 대해 게시된 기능 집합을 열거하는 StringList 개체를 반환합니다.
FeatureState
기능의 설치된 상태를 반환합니다.
FeatureUsageCount
기능이 사용된 횟수를 반환합니다.
FeatureUsageDate
지정된 기능이 마지막으로 사용된 날짜를 반환합니다.
FileAttributes
파일 또는 폴더의 지정된 경로에 대해 결합된 파일 특성을 나타내는 숫자를 반환합니다.
패치
제품에 적용된 모든 패치가 포함된 StringList 개체를 반환합니다.
PatchesEx
Patch 개체 컬렉션을 열거합니다.
PatchFiles
제공된 패치 목록으로 업데이트할 수 있는 파일 목록이 포함된 StringList 개체를 반환합니다.
PatchInfo
패치에 대한 정보를 반환합니다.
PatchTransforms
지정된 패치 패키지에 있고 지정된 제품에 적용된 세미콜론으로 구분된 변환 목록을 반환합니다.
ProductElevated
제품이 관리되면 True를 반환하고, 제품을 관리하지 않으면 False를 반환합니다.
ProductInfo
설치되거나 게시된 제품에 대해 지정된 특성의 값을 반환합니다.
ProductInfoFromScript
보급 스크립트에 저장된 지정된 특성의 값을 반환합니다.
제품
현재 사용자 및 컴퓨터에 대해 설치되거나 보급된 모든 제품 집합을 열거하는 StringList 개체를 반환합니다.
ProductsEx
Product 개체 컬렉션을 열거합니다.
ProductState
제품에 대한 설치 상태 정보를 반환합니다.
QualifierDescription
정규화된 구성 요소를 설명하는 텍스트 문자열을 반환합니다.
RelatedProducts
속성 테이블에 지정된 UpgradeCode 속성이 있는 현재 사용자 및 컴퓨터에 대해 설치되거나 보급된 모든 제품 집합을 열거하는 StringList 개체를 반환합니다.
ShortcutTarget
바로 가기를 검사하고 제품, 기능 이름 및 구성 요소를 반환합니다(사용 가능한 경우).
SummaryInformation
패키지 또는 변환의 요약 정보 스트림에 속성을 검사, 업데이트 및 추가하는 데 사용할 수 있는 SummaryInfo 개체를 반환합니다.
UILevel
읽기/쓰기
현재 프로세스 공간 내에서 후속 패키지를 열고 처리할 때 사용할 사용자 인터페이스의 유형을 나타냅니다.
버전
현재 버전의 Windows Installer에 대한 문자열 표현을 반환합니다.

 

요구 사항

요구 사항
버전
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으로 정의됩니다.

추가 정보

Automation 인터페이스 사용

Windows Installer 스크립팅 예제