다음을 통해 공유

설치 관리자 함수 참조

  • 아티클

애플리케이션에서 Windows Installer를 사용하도록 설정하려면 설치 관리자 함수를 사용해야 합니다. 이 항목의 표는 함수를 범주별로 보여 줍니다.

사용자 인터페이스 및 로깅 함수

속성 설명
MsiSetInternalUI 설치 관리자의 내부 사용자 인터페이스를 사용하도록 설정합니다.
MsiSetExternalUI 문자열 형식으로 메시지를 수신하는 외부 사용자 인터페이스 처리기를 사용하도록 설정합니다.
MsiSetExternalUIRecord 레코드 형식으로 메시지를 수신하는 외부 사용자 인터페이스 처리기를 사용하도록 설정합니다.
MsiEnableLog 호출 프로세스의 모든 설치에 대한 로그 모드를 설정합니다.

 

핸들 관리 함수

속성 설명
MsiCloseHandle 열린 설치 핸들을 닫습니다.
MsiCloseAllHandles 열린 설치 핸들을 모두 닫습니다. 정리에는 사용하지 마세요.

 

설치 및 구성 함수

속성 설명
MsiAdvertiseProduct 제품을 보급합니다.
MsiAdvertiseProductEx 제품을 보급합니다.
MsiAdvertiseScript 보급 스크립트 파일을 지정된 위치에 복사합니다.
MsiInstallProduct 애플리케이션 또는 애플리케이션 제품군을 설치하거나 제거합니다.
MsiConfigureProduct 애플리케이션 또는 애플리케이션 제품군을 설치하거나 제거합니다.
MsiConfigureProductEx 애플리케이션 또는 애플리케이션 제품군을 설치하거나 제거합니다. 제품 명령줄을 지정할 수 있습니다.
MsiReinstallProduct 설치를 다시 설치하거나 복구합니다.
MsiConfigureFeature 기능의 설치된 상태를 구성합니다.
MsiReinstallFeature 기능의 유효성을 검사하거나 복구합니다.
MsiInstallMissingComponent 누락된 구성 요소를 설치합니다.
MsiInstallMissingFile 누락된 파일을 설치합니다.
MsiNotifySidChange 사용자 SID에 대한 변경 내용으로 Windows Installer 내부 정보를 알리고 업데이트합니다. Windows Installer 3.1부터 사용할 수 있습니다.
MsiProcessAdvertiseScript 보급 스크립트 파일을 지정된 위치로 처리합니다.
MsiSourceListAddSource 지정된 컨텍스트에서 패치 또는 제품의 원본을 추가하거나 순서를 변경합니다.
MsiSourceListAddSourceEx 지정된 컨텍스트에서 패치 또는 제품의 원본을 추가하거나 순서를 변경합니다. 지정된 컨텍스트에 없는 패치에 대한 원본 목록을 만듭니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiSourceListClearSource 지정된 컨텍스트에서 제품 또는 패치에 대한 기존 원본을 제거합니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiSourceListClearAll 지정된 제품 인스턴스에 대한 특정 원본 유형의 기존 원본을 모두 제거합니다.
MsiSourceListClearAllEx 지정된 제품 인스턴스에 대한 특정 원본 유형의 기존 원본을 모두 제거합니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiSourceListForceResolution "LastUsedSource" 속성으로 등록된 제품 또는 패치의 현재 원본 등록을 제거합니다. 이 함수는 등록된 원본 목록에 영향을 주지 않습니다.
MsiSourceListForceResolutionEx "LastUsedSource" 속성으로 등록된 제품 또는 패치의 현재 원본 등록을 제거합니다. 이 함수는 등록된 원본 목록에 영향을 주지 않습니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiSourceListGetInfo 특정 컨텍스트에서 제품 또는 패치의 원본 목록에 대한 정보를 검색합니다.
MsiSourceListSetInfo 지정된 컨텍스트에서 제품 또는 패치에 가장 최근에 사용된 원본을 설정합니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiSourceListEnumMediaDisks 패치 또는 제품의 미디어 원본에 등록된 디스크 목록을 열거합니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiSourceListAddMediaDisk 등록된 제품 또는 패치의 미디어 원본 디스크를 추가하거나 업데이트합니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiSourceListClearMediaDisk 특정 컨텍스트에서 제품 또는 패치의 미디어 원본 아래에 기존에 등록된 디스크를 제거합니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiSourceListEnumSources 지정된 패치 또는 제품의 원본 목록에서 원본을 열거합니다. Windows Installer 3.0에서 사용할 수 있습니다.

 

구성 요소별 함수

속성 설명
MsiProvideAssembly 어셈블리의 전체 구성 요소 경로를 설치하고 반환합니다.
MsiProvideComponent 구성 요소의 전체 구성 요소 경로를 설치하고 반환합니다.
MsiProvideQualifiedComponent 정규화된 구성 요소의 전체 구성 요소 경로를 설치하고 반환합니다.
MsiProvideQualifiedComponentEx 제품에서 게시하는 정규화된 구성 요소의 전체 구성 요소 경로를 설치하고 반환합니다.
MsiGetComponentPath 설치된 구성 요소에 대한 전체 경로 또는 레지스트리 키를 반환합니다.
MsiGetComponentPathEx 사용자 계정 및 설치 컨텍스트 전체에서 설치된 구성 요소에 대한 전체 경로 또는 레지스트리 키를 반환합니다. Windows Installer 4.5 이하: 지원되지 않습니다.
MsiLocateComponent 제품 코드 없이 설치된 구성 요소의 전체 경로를 반환합니다.
MsiQueryComponentState 구성 요소에 대해 설치된 상태를 반환합니다. 현재 사용자 이외의 사용자 계정으로 설치된 제품 인스턴스의 구성 요소를 쿼리할 수 있습니다. Windows Installer 3.0 이상에서 사용할 수 있습니다.

 

애플리케이션 전용 함수

속성 설명
MsiCollectUserInfo 설치 마법사의 사용자 정보를 저장합니다.
MsiUseFeature 기능의 사용 횟수를 증분시키고 설치 상태를 나타냅니다.
MsiUseFeatureEx 기능의 사용 횟수를 증분시키고 설치 상태를 나타냅니다.
MsiGetProductCode 구성 요소 코드를 사용하여 제품 코드를 반환합니다.

 

시스템 상태 함수

속성 설명
MsiEnumProducts 보급된 제품을 열거합니다.
MsiEnumProductsEx 지정된 컨텍스트에서 보급되거나 설치된 제품의 모든 인스턴스를 열거합니다. Windows Installer 3.0 이상에서 사용할 수 있습니다.
MsiEnumRelatedProducts 지정된 업그레이드 코드가 있는 현재 설치된 제품을 열거합니다.
MsiEnumFeatures 게시된 기능을 열거합니다.
MsiEnumComponents 설치된 구성 요소를 열거합니다.
MsiEnumComponentsEx 사용자 계정 및 설치 컨텍스트에서 설치된 구성 요소를 열거합니다. Windows Installer 4.5 이하: 지원되지 않습니다.
MsiEnumClients 설치된 구성 요소의 클라이언트를 열거합니다.
MsiEnumClientsEx 사용자 계정 및 설치 컨텍스트 전체에서 설치된 구성 요소의 클라이언트를 열거합니다. Windows Installer 4.5 이하: 지원되지 않습니다.
MsiEnumComponentQualifiers 구성 요소에 대해 보급된 한정자를 열거합니다.
MsiQueryFeatureState 기능의 설치된 상태를 반환합니다.
MsiQueryFeatureStateEx 제품 기능에 대해 설치된 상태를 반환합니다. 현재 사용자 이외의 사용자 계정으로 설치된 제품 인스턴스의 기능을 쿼리할 수 있습니다. Windows Installer 3.0 이상에서 사용할 수 있습니다.
MsiQueryProductState 애플리케이션 또는 애플리케이션 제품군에 대해 설치된 상태를 반환합니다.
MsiGetFeatureUsage 기능에 대한 사용 현황 메트릭을 반환합니다.
MsiGetProductInfo 게시된 제품 및 설치된 제품에 대한 제품 정보를 반환합니다.
MsiGetProductInfoEx 보급된 제품 및 설치된 제품에 대한 제품 정보를 반환합니다. 현재 사용자가 아닌 사용자 계정으로 설치된 제품의 인스턴스에 대한 정보를 검색할 수 있습니다. Windows Installer 3.0 이상에서 사용할 수 있습니다.
MsiGetUserInfo 설치된 제품에 대해 등록된 사용자 정보를 반환합니다.

 

제품 쿼리 함수

속성 설명
MsiOpenProduct 데이터베이스에 액세스하는 함수와 함께 사용할 제품을 엽니다.
MsiOpenPackage 데이터베이스에 액세스하는 함수와 함께 사용할 패키지를 엽니다.
MsiOpenPackageEx 데이터베이스에 액세스하는 함수와 함께 사용할 패키지를 엽니다.
MsiIsProductElevated 제품이 상승된 권한으로 설치되어 있는지 확인합니다.
MsiGetProductInfoFromScript 설치 관리자 스크립트 파일에 대한 제품 정보를 반환합니다.
MsiGetProductProperty 제품 데이터베이스의 속성을 검색합니다.
MsiGetShortcutTarget 바로 가기를 검사하고 제품, 기능 이름 및 구성 요소를 반환합니다(사용 가능한 경우).
MsiGetFeatureInfo 기능에 대한 설명 정보를 반환합니다.
MsiVerifyPackage 지정된 파일이 설치 패키지인지 확인합니다.

 

패치 함수

속성 설명
MsiApplyPatch 설치를 호출하고 패치 패키지를 적용합니다.
MsiEnumPatches 제품에 적용되는 각 패치의 GUID와 제품에 적용되는 각 패치의 변환 목록을 반환합니다.
MsiGetPatchInfo 패치에 대한 정보를 반환합니다.
MsiRemovePatches 제품에서 패치를 제거합니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiDeterminePatchSequence 패치 및 제품 세트에 가장 적합한 애플리케이션 시퀀스를 결정합니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiApplyMultiplePatches 제품에 하나 이상의 패치를 적용합니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiEnumPatchesEx 특정 컨텍스트 또는 모든 컨텍스트에서 제품에 적용된 모든 패치를 열거합니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiGetPatchFileList .msp 파일 목록이 제공되면 이 함수는 대상에 대한 패치로 업데이트할 수 있는 파일 목록을 검색합니다. Windows Installer 4.0에서 사용할 수 있습니다.
MsiGetPatchInfoEx 지정된 제품에 지정된 패치를 적용하는 방법에 대한 정보를 쿼리합니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiExtractPatchXMLData 패치에서 정보를 추출합니다. Windows Installer 3.0에서 사용할 수 있습니다.
MsiDetermineApplicablePatches 제품 또는 제품 집합을 업데이트하는 데 필요한 최상의 패치 집합을 결정합니다. Windows Installer 3.0에서 사용할 수 있습니다.

 

파일 쿼리 함수

속성 설명
MsiGetFileHash 파일에 대한 경로를 가져와 해당 파일의 128비트 해시를 반환합니다.
MsiGetFileSignatureInformation 디지털 서명된 파일의 경로를 가져와 파일의 서명자 인증서 및 해시를 반환합니다.
MsiGetFileVersion 버전 문자열 및 언어 문자열을 반환합니다.

 

트랜잭션 관리 함수

속성 설명
MsiBeginTransaction 다중 패키지 설치의 트랜잭션 처리를 시작하고 트랜잭션에 대한 식별자를 반환합니다. 이 함수는 Windows Installer 4.5부터 사용할 수 있습니다.
MsiJoinTransaction Windows Installer가 현재 프로세스를 다중 패키지 설치를 진행하는 트랜잭션의 소유자로 만들도록 요청합니다. 이 함수는 Windows Installer 4.5부터 사용할 수 있습니다.
MsiEndTransaction 트랜잭션에 속한 모든 설치를 커밋하거나 롤백합니다. 이 함수는 Windows Installer 4.5부터 사용할 수 있습니다.

 

데이터베이스 함수

이전 테이블에서 식별된 Windows Installer 함수 외에도 데이터베이스 함수 섹션에 설명된 데이터베이스 액세스 함수를 사용하여 설치 데이터베이스의 정보를 조작할 수 있습니다.

설치 관리자 구조

또한 설치 데이터베이스의 일부 정보는 설치 관리자 구조 섹션에 설명된 구조를 사용하여 처리됩니다.