MsiReinstallFeatureA 함수(msi.h)
MsiReinstallFeature 함수는 기능을 다시 설치합니다.
구문
UINT MsiReinstallFeatureA(
[in] LPCSTR szProduct,
[in] LPCSTR szFeature,
[in] DWORD dwReinstallMode
);
매개 변수
[in] szProduct
다시 설치할 기능이 포함된 제품의 제품 코드를 지정합니다.
[in] szFeature
다시 설치할 기능을 지정합니다. 지정된 기능의 부모 기능 또는 자식 기능이 다시 설치되지 않습니다. 부모 또는 자식 기능을 다시 설치하려면 각각 에 대해 MsiReinstallFeature 함수를 개별적으로 호출하거나 MsiReinstallProduct 함수를 사용해야 합니다.
[in] dwReinstallMode
설치할 내용을 지정합니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.
| 값 | 의미 |
|---|---|
|
파일이 없는 경우에만 다시 설치합니다. |
|
파일이 없거나 이전 버전인 경우 다시 설치합니다. |
|
파일이 없거나 동일하거나 이전 버전인 경우 다시 설치합니다. |
|
파일이 없거나 다른 버전이면 다시 설치합니다. |
|
체크섬 값을 확인하고, 누락되거나 손상된 경우 파일을 다시 설치합니다. 이 플래그는 파일 테이블의 특성 열에 msidbFileAttributesChecksum이 있는 파일만 복구합니다. |
|
체크섬 또는 버전에 관계없이 모든 파일을 강제로 다시 설치합니다. |
|
HKEY_CURRENT_USER 이동하는 레지스트리 테이블에서 필요한 모든 레지스트리 항목을 다시 작성합니다. 또는 HKEY_USERS 레지스트리 하이브. |
|
HKEY_LOCAL_MACHINE로 이동하는 레지스트리 테이블에서 필요한 모든 레지스트리 항목을 다시 작성합니다. 또는 HKEY_CLASSES_ROOT 레지스트리 하이브. 시스템이나 사용자 할당에 관계없이 클래스 테이블, 동사 테이블, PublishComponent 테이블, ProgID 테이블, MIME 테이블, 아이콘 테이블, 확장 테이블, AppID 테이블의 모든 정보를 다시 씁니다. 모든 정규화된 구성 요소를 다시 설치합니다.
애플리케이션을 다시 설치할 때 이 옵션은 RegisterTypeLibraries 및 InstallODBC 작업을 실행합니다. |
|
모든 바로 가기를 다시 설치하고 기존 바로 가기 및 아이콘을 덮어쓰는 모든 아이콘을 다시 캐시합니다. |
|
원본 패키지에서 실행하고 로컬 패키지를 다시 캐시할 때 사용합니다. 애플리케이션 또는 기능의 첫 번째 설치에는 를 사용하지 마세요. |
반환 값
| 반환 코드 | 설명 |
|---|---|
|
설치에 실패했습니다. |
|
잘못된 매개 변수가 함수에 전달되었습니다. |
|
설치 서비스에 액세스할 수 없습니다. |
|
설치가 일시 중단되었으며 불완전합니다. |
|
사용자가 설치를 취소했습니다. |
|
함수가 성공적으로 완료되었습니다. |
|
기능 ID는 알려진 기능을 식별하지 않습니다. |
|
제품 코드는 알려진 제품을 식별하지 않습니다. |
자세한 내용은 표시된 오류 메시지를 참조하세요.
설명
참고
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 런타임 요구 사항을 참조하세요. |
| 대상 플랫폼 | Windows |
| 헤더 | msi.h |
| 라이브러리 | Msi.lib |
| DLL | Msi.dll |