다음을 통해 공유


MsiSetInstallLevel 함수(msiquery.h)

MsiSetInstallLevel 함수는 전체 제품 설치에 대한 설치 수준을 설정합니다.

구문

UINT MsiSetInstallLevel(
  [in] MSIHANDLE hInstall,
  [in] int       iInstallLevel
);

매개 변수

[in] hInstall

DLL 사용자 지정 작업에 제공되거나 MsiOpenPackage, MsiOpenPackageEx 또는 MsiOpenProduct를 사용하여 가져온 설치에 대한 핸들입니다.

[in] iInstallLevel

설치 수준입니다.

반환 값

MsiSetInstallLevel 함수는 다음 값 중 하나를 반환합니다.

설명

MsiSetInstallLevel 함수는 다음을 설정합니다.

  • 지정된 값에 대한 현재 설치의 설치 수준입니다.
  • 기능 테이블의 모든 기능에 대한 선택 및 설치됨 상태입니다.
  • 새 수준에 따라 구성 요소 테이블에 있는 각 구성 요소의 작업 상태입니다.
모든 설치에는 정의된 설치 수준이 있으며, 1에서 32,767까지의 정수 값입니다. 초기 값은 속성 테이블에 설정된 INSTALLLEVEL 속성에 의해 결정됩니다.

iInstallLevel 매개 변수에 0 또는 음수가 전달되면 현재 설치 수준은 변경되지 않지만 모든 기능은 현재 설치 수준에 따라 계속 업데이트됩니다. 자세한 내용은 프로그램에서 데이터베이스 함수 호출을 참조하세요.

함수가 실패하면 MsiGetLastErrorRecord를 사용하여 확장된 오류 정보를 얻을 수 있습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 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
대상 플랫폼 Windows
헤더 msiquery.h
라이브러리 Msi.lib
DLL Msi.dll

추가 정보

설치 관리자 선택 함수