다음을 통해 공유


MsiReinstallFeatureA 함수(msi.h)

MsiReinstallFeature 함수는 기능을 다시 설치합니다.

통사론

UINT MsiReinstallFeatureA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwReinstallMode
);

매개 변수

[in] szProduct

다시 설치할 기능이 포함된 제품의 제품 코드를 지정합니다.

[in] szFeature

다시 설치할 기능을 지정합니다. 지정된 기능의 부모 기능 또는 자식 기능이 다시 설치되지 않습니다. 부모 또는 자식 기능을 다시 설치하려면 각각에 대해 MsiReinstallFeature 함수를 개별적으로 호출하거나 MsiReinstallProduct 함수를 사용해야 합니다.

[in] dwReinstallMode

설치할 내용을 지정합니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

의미
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 테이블모든 정보를 다시 작성합니다. , MIME 테이블, 아이콘 테이블, 확장 테이블및 컴퓨터 또는 사용자 할당에 관계없이 AppID 테이블 . 모든 정규화된 구성 요소를 다시 설치합니다.

애플리케이션을 다시 설치할 때 이 옵션은 RegisterTypeLibraries 실행하고 InstallODBC 작업을 .

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

반환 값

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

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

발언

메모

msi.h 헤더는 MSiReinstallFeature를 유니코드 전처리기 상수의 정의에 따라 이 함수의 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 Run-Time 요구 사항을 참조하세요.
대상 플랫폼 Windows
헤더 msi.h
라이브러리 Msi.lib
DLL Msi.dll

참고 항목

설치 및 구성 함수

Multiple-Package 설치

REINSTALLMODE 속성