MsiRemovePatchesA 함수(msi.h)

아티클
08/24/2023

MsiRemovePatches 함수는 단일 제품에서 하나 이상의 패치를 제거합니다. 여러 제품에서 패치를 제거하려면 각 제품에 대해 MsiRemovePatches 를 호출해야 합니다.

구문

UINT MsiRemovePatchesA(
  [in]           LPCSTR      szPatchList,
  [in]           LPCSTR      szProductCode,
  [in]           INSTALLTYPE eUninstallType,
  [in, optional] LPCSTR      szPropertyList
);

매개 변수

[in] szPatchList

제거할 패치 목록을 나타내는 null로 끝나는 문자열입니다. 각 패치는 패치의 GUID 또는 패치 패키지의 전체 경로로 지정할 수 있습니다. 목록의 패치는 세미콜론으로 구분됩니다.

[in] szProductCode

패치가 제거되는 제품의 PRODUCTCode (GUID)인 null로 끝나는 문자열입니다. 이 매개 변수는 NULL일 수 없습니다.

[in] eUninstallType

수행할 패치 제거 유형을 나타내는 값입니다. 이 매개 변수는 INSTALLTYPE_SINGLE_INSTANCE 합니다.

값	의미
INSTALLTYPE_SINGLE_INSTANCE	패치는 szProduct로 지정된 제품에 대해서만 제거됩니다.

[in, optional] szPropertyList

명령줄 속성 설정을 지정하는 null로 끝나는 문자열입니다. 자세한 내용은
명령줄의 속성 정보 및 공용 속성 값 설정 이 매개 변수는 NULL일 수 있습니다.

반환 값

MsiRemovePatches 함수는 다음 값을 반환합니다.

값	의미
ERROR_INVALID_PARAMETER	잘못된 매개 변수가 포함되었습니다.
ERROR_PATCH_PACKAGE_OPEN_FAILED	패치 패키지를 열 수 없습니다.
ERROR_SUCCESS	패치가 성공적으로 제거되었습니다.
ERROR_UNKNOWN_PRODUCT	szProductList로 지정된 제품은 MsiRemovePatches의 호출자에 대해 컴퓨터당 또는 사용자별로 설치되지 않습니다.
ERROR_PATCH_PACKAGE_OPEN_FAILED	패치 패키지를 열 수 없습니다.
ERROR_PATCH_PACKAGE_INVALID	패치 패키지가 잘못되었습니다.
ERROR_PATCH_PACKAGE_UNSUPPORTED	이 버전의 Windows Installer 서비스에서 패치 패키지를 처리할 수 없습니다.
ERROR_PATCH_REMOVAL_UNSUPPORTED	패치 패키지는 이동식이 아닙니다.
ERROR_UNKNOWN_PATCH	패치가 이 제품에 적용되지 않았습니다.
ERROR_PATCH_REMOVAL_DISALLOWED	패치 제거는 정책에 따라 허용되지 않습니다.

설명

사용자가 사용할 수 있는 모든 제품에서 애플리케이션이 패치를 제거하는 방법을 보여 주는 예제는 패치 제거를 참조하세요.

참고

msi.h 헤더는 MSiRemovePatches를 유니코드 전처리기 상수의 정의에 따라 이 함수의 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 Installer 버전에 필요한 최소 Windows 서비스 팩에 대한 자세한 내용은 Windows Installer 런타임 요구 사항을 참조하세요.
대상 플랫폼	Windows
헤더	msi.h
라이브러리	Msi.lib
DLL	Msi.dll