IUpdateInstaller::BeginInstall 메서드(wuapi.h)

업데이트의 비동기 설치를 시작합니다.

구문

HRESULT BeginInstall(
  [in]  IUnknown         *onProgressChanged,
  [in]  IUnknown         *onCompleted,
  [in]  VARIANT          state,
  [out] IInstallationJob **retval
);

매개 변수

[in] onProgressChanged

설치가 완료되기 전에 설치 진행률을 변경하기 위해 주기적으로 호출되는 IInstallationProgressChangedCallback 인터페이스입니다.

[in] onCompleted

설치 작업이 완료될 때 호출되는 IInstallationCompletedCallback 인터페이스입니다.

[in] state

IInstallationJob 인터페이스의 AsyncState 속성에서 반환되는 호출자별 상태입니다.

[out] retval

시작된 비동기 설치 작업에 사용할 수 있는 속성과 메서드를 포함하는 IInstallationJob 인터페이스입니다.

반환 값

이 메서드는 다음 HRESULT 값 및 기타 COM 또는 Windows를 반환합니다.

오류 코드입니다.

반환 코드	설명
S_OK	업데이트의 비동기 설치가 성공적으로 시작되었습니다.
WU_E_INSTALL_NOT_ALLOWED	설치 관리자가 업데이트를 설치하거나 제거할 때는 이 메서드를 호출할 수 없습니다. IUpdateInstaller 인터페이스의 IsBusy 속성이 VARIANT_FALSE 반환하는 경우에만 이 메서드를 호출합니다.
WU_E_NO_UPDATE	WUA(Windows 업데이트 에이전트)에는 컬렉션에 업데이트가 없습니다.

설명

스크립팅 언어에서 이 메서드를 호출하는 경우 콜백 루틴을 구현하는 DSIPID(디스패치 식별자)가 0인 Automation 개체의 식별자에 onProgressChanged 매개 변수를 설정합니다. onCompleted 매개 변수에 대해 동일한 작업을 수행합니다.

이 메서드는 IUpdateInstaller의 업데이트 속성이 설정되지 않은 경우 WU_E_NO_UPDATE 반환합니다. 또한 이 메서드는 업데이트 속성이 빈 컬렉션으로 설정된 경우 WU_E_NO_UPDATE 반환합니다.

앱에서 비동기 WUA API를 사용하는 경우 시간 제한 메커니즘을 구현해야 할 수 있습니다. 비동기 WUA 작업을 수행하는 방법에 대한 자세한 내용은 비동기 WUA 작업에 대한 지침을 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows XP, Windows 2000 Professional SP3 포함 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003, Windows 2000 Server SP3 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wuapi.h
라이브러리	Wuguid.lib
DLL	Wuapi.dll

참고 항목

IUpdateInstaller