다음을 통해 공유


MsiReinstallProductA 함수(msi.h)

MsiReinstallProduct 함수는 제품을 다시 설치합니다.

구문

UINT MsiReinstallProductA(
  [in] LPCSTR szProduct,
  [in] DWORD  szReinstallMode
);

매개 변수

[in] szProduct

제품을 다시 설치할 제품 코드를 지정합니다.

[in] szReinstallMode

다시 설치 모드를 지정합니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

의미
REINSTALLMODE_FILEMISSING
파일이 없는 경우에만 다시 설치합니다.
REINSTALLMODE_FILEOLDERVERSION
파일이 없거나 이전 버전인 경우 다시 설치합니다.
REINSTALLMODE_FILEEQUALVERSION
파일이 없거나 동일하거나 이전 버전인 경우 다시 설치합니다.
REINSTALLMODE_FILEEXACT
파일이 없거나 다른 버전이면 다시 설치합니다.
REINSTALLMODE_FILEVERIFY
체크섬 값을 확인하고 누락되거나 손상된 경우 파일을 다시 설치합니다. 이 플래그는 파일 테이블의 특성 열에 msidbFileAttributesChecksum이 있는 파일만 복구합니다.
REINSTALLMODE_FILEREPLACE
체크섬 또는 버전에 관계없이 모든 파일을 강제로 다시 설치합니다.
REINSTALLMODE_USERDATA
HKEY_CURRENT_USER 이동하는 레지스트리 테이블에서 필요한 모든 레지스트리 항목을 다시 작성합니다.

또는 HKEY_USERS

레지스트리 하이브.
REINSTALLMODE_MACHINEDATA
HKEY_LOCAL_MACHINE로 이동하는 레지스트리 테이블에서 필요한 모든 레지스트리 항목을 다시 작성합니다.

또는 HKEY_CLASSES_ROOT

레지스트리 하이브. 컴퓨터 또는 사용자 할당에 관계없이 클래스 테이블, 동사 테이블, PublishComponent 테이블, ProgID 테이블, MIMET 테이블, 아이콘 테이블, 확장 테이블AppID 테이블 의 모든 정보를 다시 작성합니다. 모든 정규화된 구성 요소를 다시 설치합니다.

애플리케이션을 다시 설치할 때 이 옵션은 RegisterTypeLibrariesInstallODBC 작업을 실행합니다.

REINSTALLMODE_SHORTCUT
모든 바로 가기를 다시 설치하고 기존 바로 가기 및 아이콘을 덮어쓰는 모든 아이콘을 다시 캐시합니다.
REINSTALLMODE_PACKAGE
원본 패키지에서 실행하고 로컬 패키지를 다시 캐시할 때 사용합니다. 애플리케이션 또는 기능의 첫 번째 설치에는 를 사용하지 마세요.

반환 값

반환 코드 설명
ERROR_INSTALL_FAILURE
설치에 실패했습니다.
ERROR_INVALID_PARAMETER
잘못된 매개 변수가 함수에 전달되었습니다.
ERROR_INSTALL_SERVICE_FAILURE
설치 서비스에 액세스할 수 없습니다.
ERROR_INSTALL_SUSPEND
설치가 일시 중단되었으며 불완전합니다.
ERROR_INSTALL_USEREXIT
사용자가 설치를 취소했습니다.
ERROR_SUCCESS
함수가 성공적으로 완료되었습니다.
ERROR_UNKNOWN_PRODUCT
제품 코드는 알려진 제품을 식별하지 않습니다.
 

자세한 내용은 표시된 오류 메시지를 참조하세요.

설명

참고

msi.h 헤더는 MSiReinstallProduct를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 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 Installer 버전에 필요한 최소 Windows 서비스 팩에 대한 자세한 내용은 Windows Installer 런타임 요구 사항을 참조하세요.
대상 플랫폼 Windows
헤더 msi.h
라이브러리 Msi.lib
DLL Msi.dll

참고 항목

설치 및 구성 함수

여러 패키지 설치

REINSTALLMODE 속성