InstallApplication 함수(appmgmt.h)
InstallApplication 함수는 도메인에 속한 대상 사용자에게 배포된 애플리케이션을 설치할 수 있습니다. InstallApplication을 호출하는 사용자의 보안 컨텍스트는 대상 사용자의 도메인을 신뢰하는 도메인의 컴퓨터에 로그온한 도메인 사용자의 보안 컨텍스트여야 합니다. 대상 사용자가 로그온할 때 그룹 정책 성공적으로 적용해야 합니다.
구문
DWORD InstallApplication(
[in] PINSTALLDATA pInstallInfo
);
매개 변수
[in] pInstallInfo
설치할 애플리케이션을 지정하는 INSTALLDATA 구조체에 대한 포인터입니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS. 그렇지 않으면 함수는 시스템 오류 코드 중 하나를 반환합니다. 오류 코드의 전체 목록은 시스템 오류 코드 또는 헤더 파일 WinError.h를 참조하세요.
설명
InstallApplication 함수는 그룹 정책 사용하여 배포된 애플리케이션만 설치할 수 있습니다. 도메인 관리자는 GPO(그룹 정책 Objects)의 사용자 구성 섹션을 사용하여 대상 사용자에게 애플리케이션을 배포할 수 있습니다. 대상 사용자는 대상 도메인에 속해야 하며 GPO는 대상 도메인의 이 사용자에게 적용되어야 합니다. InstallApplication 함수는 표준 그룹 정책 상속 규칙에 따라 애플리케이션을 설치합니다. 동일한 애플리케이션이 여러 GPO에 배포된 경우 함수는 가장 높은 우선 순위 GPO에 배포된 애플리케이션 버전을 설치합니다. 사용자에 대해 애플리케이션을 설치한 후에는 컴퓨터의 다른 사용자에게 표시되지 않습니다. 이는 사용자 그룹 정책을 통해 배포되는 애플리케이션에 대한 표준입니다.
InstallApplication 함수는 Windows Installer(.msi 파일) 또는 소프트웨어 설치 설정(.zap 파일)을 사용하여 설치 및 설치를 처리하는 배포된 애플리케이션을 설치할 수 있습니다.
InstallApplication 함수는 설치에 Windows Installer 패키지를 사용하는 애플리케이션을 설치할 수 있습니다. 이 경우 InstallApplication 을 호출하는 사용자는 관리자 권한이 필요하지 않습니다. Windows Installer는 도메인 관리자가 배포한 신뢰할 수 있는 애플리케이션이므로 시스템에서 애플리케이션을 설치할 수 있습니다. 애플리케이션을 수신하는 사용자는 .msi 파일의 위치에 액세스할 수 있어야 합니다.
Windows Installer 함수 MsiConfigureProduct를 호출하여 .msi 파일을 사용하여 설치된 애플리케이션을 제거하여 애플리케이션을 제거합니다. 그런 다음 UninstallApplication을 호출하여 그룹 정책 애플리케이션이 클라이언트에서 더 이상 관리되지 않음을 시스템에 알릴 수 있습니다. 제거가 실패하더라도 시스템에서 RSoP(결과 정책 집합)를 정확하게 유지할 수 있으므로 UninstallApplication을 호출해야 합니다.
InstallApplication 함수는 소프트웨어 설치 설정(.zap 파일)에 따라 설치 애플리케이션을 사용하는 애플리케이션을 설치할 수도 있습니다. 애플리케이션을 받는 사용자는 .zap 파일의 위치에 액세스할 수 있어야 합니다. .zap 파일은 .ini 파일과 유사한 텍스트 파일로, Windows에서 프로그램 추가 또는 제거를 사용하여 설치할 애플리케이션(예: Setup.exe)을 게시할 수 있습니다. Windows Installer를 사용하지 않는 애플리케이션을 게시하려면 .zap 파일을 만들고 소프트웨어 배포 지점 서버에 .zap 파일을 복사한 다음 그룹 정책 기반 소프트웨어 배포를 사용하여 사용자를 위한 애플리케이션을 게시해야 합니다. .zap 파일을 사용하여 애플리케이션을 배포하는 경우 애플리케이션을 설치하는 사용자에게 소프트웨어를 설치하려면 컴퓨터에 대한 권한이 있어야 합니다. 할당된 애플리케이션에는 .zap 파일을 사용할 수 없습니다.
설치 애플리케이션에 해당하는 제거 함수 또는 명령을 호출하여 소프트웨어 설치 설정(.zap 파일)을 사용하여 애플리케이션을 제거합니다.
Windows 설치 관리자 이외의 설치 애플리케이션을 사용하는 방법에 대한 자세한 내용은 Microsoft 기술 자료의 ".zap Files를 사용하여 비 MSI 프로그램을 게시하는 방법"231747 문서를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | appmgmt.h |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |
| API 세트 | ext-ms-win-advapi32-msi-l1-1-0(Windows 8 도입) |