UninstallApplication 함수(appmgmt.h)
UninstallApplication 함수는 Windows Installer .msi 파일을 사용하여 설치 및 설치를 처리하는 그룹 정책 애플리케이션을 제거합니다. UninstallApplication 함수는 사용자 그룹 정책 애플리케이션이 이전에 MsiConfigureProduct 함수를 호출하여 제거를 시도한 사용자의 컨텍스트에서만 호출되어야 합니다. InstallApplication 함수는 그룹 정책 애플리케이션을 설치할 수 있습니다.
구문
DWORD UninstallApplication(
[in] LPWSTR ProductCode,
[in] DWORD dwStatus
);
매개 변수
[in] ProductCode
제거되는 제품의 Windows Installer 제품 코드입니다. 애플리케이션의 제품 코드 는 중괄호가 있는 문자열로 Windows Installer GUID 형식으로 제공해야 합니다.
[in] dwStatus
제거 시도의 상태. dwStatus 매개 변수는 MsiConfigureProduct에서 반환한 제거 시도의 Windows 성공 코드입니다. 시스템에서 이를 사용하여 RSoP(결과 정책 집합) 에서 제거가 실패했는지 또는 성공했는지 여부를 표시할 수 있습니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS. 그렇지 않으면 함수는 시스템 오류 코드 중 하나를 반환합니다. 오류 코드의 전체 목록은 시스템 오류 코드 또는 헤더 파일 WinError.h를 참조하세요.
설명
Windows Installer 함수 MsiConfigureProduct를 호출하여 애플리케이션을 제거하여 .msi 파일을 사용하는 그룹 정책 애플리케이션을 제거합니다. 그런 다음 UninstallApplication을 호출하여 그룹 정책 애플리케이션이 클라이언트에서 더 이상 관리되지 않음을 시스템에 알릴 수 있습니다. 제거가 실패하더라도 시스템에서 RSoP(결과 정책 집합)를 정확하게 유지할 수 있으므로 UninstallApplication을 호출해야 합니다.
설치 애플리케이션에 해당하는 제거 함수 또는 명령을 호출하여 소프트웨어 설치 설정(.zap 파일)을 사용하여 설치된 애플리케이션을 제거합니다. Windows Installer 이외의 설치 애플리케이션을 사용하는 방법에 대한 자세한 내용은 Microsoft 기술 자료의 ".zap 파일로 비 MSI 프로그램을 게시하는 방법" 문서 231747 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | appmgmt.h |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |