데이터베이스 함수
이 자료는 자체 설치 프로그램을 작성하는 개발자와 설치 관리자 데이터베이스 테이블에 대해 자세히 알고자 하는 개발자를 대상으로 합니다. 설치 관리자에 대한 일반적인 내용은 Windows Installer 정보를 참조하세요.
설치 관리자 액세스 함수를 사용하여 데이터베이스 및 설치 프로세스에 액세스할 수 있습니다. 이러한 함수는 사용자 지정 설치 작업 및 작성 도구에서만 사용해야 합니다. 일부 설치 관리자 액세스 함수에는 데이터베이스를 쿼리하기 위한 SQL 쿼리 문자열이 필요합니다. 쿼리는 설치 관리자 SQL 구문을 준수해야 합니다.
이 항목에서는 설치 관리자 데이터베이스 액세스 함수를 범주별로 나열합니다.
일반 데이터베이스 액세스 함수
| 함수 | 설명 |
|---|---|
| MsiDatabaseCommit | 데이터베이스에 변경 내용을 커밋합니다. |
| MsiDatabaseGetPrimaryKeys | 모든 기본 키 열의 이름을 반환합니다. |
| MsiDatabaseIsTablePersistent | 테이블의 상태를 설명하는 열거형을 반환합니다. |
| MsiDatabaseOpenView | 데이터베이스 쿼리를 준비하고 뷰 개체를 만듭니다. |
| MsiGetActiveDatabase | 설치의 활성 데이터베이스를 반환합니다. |
| MsiViewGetColumnInfo | 열 이름 또는 정의를 반환합니다. |
| MsiOpenDatabase | 데이터 액세스를 위해 데이터베이스 파일을 엽니다. |
| MsiViewClose | 실행된 뷰의 결과 집합을 릴리스합니다. |
| MsiViewExecute | 뷰 쿼리를 실행하고 필요한 매개 변수를 제공합니다. |
| MsiViewFetch | 뷰에서 다음 순차 레코드를 가져옵니다. |
| MsiViewGetError | MsiViewModify 함수에서 발생한 오류를 반환합니다. |
| MsiViewModify | 가져온 레코드를 업데이트합니다. |
데이터베이스 관리 함수
| 함수 | 설명 |
|---|---|
| MsiCreateTransformSummaryInfo | 기존 변환의 요약 정보를 만듭니다. |
| MsiDatabaseApplyTransform | 데이터베이스에 변환을 적용합니다. |
| MsiDatabaseExport | 열려 있는 데이터베이스에서 텍스트 보관 파일로 테이블을 내보냅니다. |
| MsiDatabaseGenerateTransform | 두 데이터베이스 간의 차이점에 대한 변환 파일을 생성합니다. |
| MsiDatabaseImport | 설치 관리자 텍스트 보관 테이블을 열린 데이터베이스로 가져옵니다. |
| MsiDatabaseMerge | 두 데이터베이스를 함께 병합합니다. |
| MsiGetDatabaseState | 데이터베이스의 상태를 반환합니다. |
레코드 처리 함수
| 함수 | 설명 |
|---|---|
| MsiCreateRecord | 지정된 수의 필드를 사용하여 새 레코드 개체를 만듭니다. |
| MsiFormatRecord | 형식 문자열을 사용하여 레코드 필드 데이터 및 속성을 형식화합니다. |
| MsiRecordClearData | 레코드의 모든 필드를 null로 설정합니다. |
| MsiRecordDataSize | 레코드 필드의 길이를 반환합니다. |
| MsiRecordGetFieldCount | 레코드의 필드 수를 반환합니다. |
| MsiRecordGetInteger | 레코드 필드에서 정수 값을 반환합니다. |
| MsiRecordGetString | 레코드 필드의 문자열 값을 반환합니다. |
| MsiRecordIsNull | 레코드 필드가 null인지 여부를 보고합니다. |
| MsiRecordReadStream | 레코드 스트림 필드에서 버퍼까지 바이트를 읽습니다. |
| MsiRecordSetInteger | 레코드 필드를 정수 필드로 설정합니다. |
| MsiRecordSetStream | 파일에서 레코드 스트림 필드를 설정합니다. |
| MsiRecordSetString | 지정된 필드에 문자열을 복사합니다. |
요약 정보 속성 함수
| 함수 | 설명 |
|---|---|
| MsiGetSummaryInformation | 설치 관리자 데이터베이스의 요약 정보 스트림에 대한 핸들을 가져옵니다. |
| MsiSummaryInfoGetProperty | 요약 정보에서 단일 속성을 가져옵니다. |
| MsiSummaryInfoGetPropertyCount | 요약 정보 스트림의 속성 수를 반환합니다. |
| MsiSummaryInfoPersist | 변경된 요약 정보를 요약 정보 스트림에 다시 씁니다. |
| MsiSummaryInfoSetProperty | 단일 요약 정보 속성을 설정합니다. |
설치 관리자 상태 액세스 함수
| 함수 | 설명 |
|---|---|
| MsiGetLanguage | 현재 설치의 숫자 언어를 반환합니다. |
| MsiGetLastErrorRecord | 호출 프로세스에 대해 마지막으로 반환된 오류 레코드를 반환합니다. |
| MsiGetMode | 부울 내부 설치 상태 중 하나를 반환합니다. |
| MsiGetProperty | 설치 관리자 속성의 값을 가져옵니다. |
| MsiSetProperty | 설치 속성의 값을 설정합니다. |
| MsiSetMode | 내부 엔진 부울 상태를 설정합니다. |
설치 관리자 작업 함수
| 함수 | 설명 |
|---|---|
| MsiDoAction | 기본 제공 작업, 사용자 지정 작업 또는 사용자 인터페이스 마법사 작업을 실행합니다. |
| MsiEvaluateCondition | 속성 이름 및 값을 포함하는 조건식을 평가합니다. |
| MsiProcessMessage | 처리를 위해 설치 관리자에 오류 레코드를 보냅니다. |
| MsiSequence | 작업 시퀀스를 실행합니다. |
설치 관리자 위치 함수
| 함수 | 설명 |
|---|---|
| MsiGetSourcePath | 디렉터리 테이블의 폴더에 대한 전체 원본 경로를 반환합니다. |
| MsiGetTargetPath | 디렉터리 테이블의 폴더에 대한 전체 대상 경로를 반환합니다. |
| MsiSetTargetPath | 디렉터리 테이블의 폴더에 대한 전체 대상 경로를 설정합니다. |
설치 관리자 선택 함수
| 함수 | 설명 |
|---|---|
| MsiEnumComponentCosts | 구성 요소를 설치하는 데 필요한 드라이브당 디스크 공간을 열거합니다. |
| MsiGetComponentState | 구성 요소의 상태를 가져옵니다. |
| MsiGetFeatureCost | 기능에 필요한 디스크 공간을 반환합니다. |
| MsiGetFeatureState | 기능의 상태를 가져옵니다. |
| MsiGetFeatureValidStates | 유효한 설치 상태를 반환합니다. |
| MsiSetComponentState | 구성 요소를 지정된 상태로 설정합니다. |
| MsiSetFeatureAttributes | 런타임에 기능의 기본 특성을 수정합니다. |
| MsiSetFeatureState | 기능을 지정된 상태로 설정합니다. |
| MsiSetInstallLevel | 전체 제품 설치의 설치 수준을 설정합니다. |
| MsiVerifyDiskSpace | 충분한 디스크 공간을 확인합니다. |
사용자 인터페이스 함수
| 함수 | 설명 |
|---|---|
| MsiEnableUIPreview | 사용자 인터페이스의 미리 보기 모드를 사용하도록 설정합니다. |
| MsiPreviewBillboard | 표시된 대화 상자에 호스트 컨트롤이 있는 광고판을 표시합니다. |
| MsiPreviewDialog | 대화 상자를 모덜리스 및 비활성으로 표시합니다. |
모든 함수는 ANSI 및 유니코드 호출을 모두 지원합니다. 이러한 함수를 사용하려면 MsiQuery.h를 포함하고 Msi.lib와 연결합니다.
설치 함수
위에 나열된 데이터베이스 액세스 함수 외에도 설치 관리자 함수 참조 섹션에 나열된 설치 관리자 함수를 사용하여 애플리케이션에 대한 설치 패키지를 만듭니다.