IUpdateDownloaderEx::BeginDownload2 메서드(wuapi.h)

중요하다

일부 정보는 상용 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보와 관련하여 명시적이거나 묵시적인 보증을 하지 않습니다.

업데이트와 연결된 콘텐츠 파일의 비동기 다운로드를 시작합니다.

통사론

HRESULT BeginDownload2(
  DownloadType downloadType,
  IUnknown     *onProgressChanged,
  IUnknown     *onCompleted,
  VARIANT      state,
  IDownloadJob **retval
);

매개 변수

downloadType

DownloadType의 값은 수행할 다운로드 유형, 전체 다운로드 또는 업데이트 부트스트래퍼만 다운로드하도록 지정하는.

메모

업데이트가 포함되지 않은 업데이트에 대한 업데이트 부트스트래퍼를 다운로드하려고 하면 오류 코드 WU_E_NOT_SUPPORTED 실패합니다.

onProgressChanged

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

onCompleted

비동기 다운로드 작업이 완료되면 호출되는 IDownloadCompletedCallback 인터페이스입니다.

state

IDownloadJob 인터페이스의 AsyncState 속성이 반환되는 호출자별 상태입니다. 호출자는 이 매개 변수를 사용하여 다운로드 작업 개체에 값을 연결할 수 있습니다. 이렇게 하면 호출자가 나중에 해당 다운로드 작업 개체에 대한 사용자 지정 정보를 검색할 수 있습니다.

메모

   IDownloadJob 인터페이스의 AsyncState 속성을 검색할 수 있지만 설정할 수는 없습니다. 이렇게 하면 호출자가 IDownloadJob 인터페이스의 AsyncState 속성으로 이미 설정된 개체의 내용을 변경할 수 없습니다. 즉, AsyncState 속성에 숫자가 포함되어 있으면 숫자를 변경할 수 없습니다. 그러나 AsyncState 속성에 안전한 배열 또는 개체가 포함된 경우 안전한 배열 또는 개체의 내용을 언제든지 변경할 수 있습니다. 호출자가 IUpdateDownloader::EndDownload호출하여 IDownloadJob 릴리스할 때 값이 해제됩니다.

retval

시작된 다운로드 작업에 사용할 수 있는 속성과 메서드가 포함된 IDownloadJob 인터페이스입니다.

반환 값

다음 값 중 하나를 포함하는 HRESULT.

값	묘사
S_OK	성공.
WU_E_INVALID_OPERATION	컴퓨터에서 업데이트 사이트에 액세스할 수 없습니다.
WU_E_NO_UPDATE	WUA(Windows 업데이트 에이전트)에는 컬렉션에 업데이트가 없습니다.
WU_E_NOT_INITIALIZED	WUA(Windows 업데이트 에이전트)가 초기화되지 않았습니다.
WU_E_NOT_SUPPORTED	업데이트 부트스트래퍼 다운로드는 업데이트가 포함되지 않은 업데이트에서 시도되었습니다.

발언

IDownloadProgressChangedCallback 인터페이스를 구현하는 대신 스크립트를 사용하여 자동화 개체에서 DISPID 0이 있는 식별자의 콜백 루틴을 구현할 수 있습니다. onProgressChanged 매개 변수의 형식은 IUnknown.

IDownloadCompletedCallback 인터페이스를 구현하는 대신 스크립트를 사용하여 자동화 개체에서 DISPID 0이 있는 식별자의 콜백 루틴을 구현할 수 있습니다. onCompleted 매개 변수의 형식은 IUnknown.

이 메서드는 인터페이스를 구현하는 개체가 잠겨 있으면 WU_E_INVALID_OPERATION 반환합니다.

이 메서드는 IUpdateDownloader 인터페이스의 Updates 속성이 설정되지 않은 경우 WU_E_NO_UPDATE 반환합니다. 이 메서드는 Updates 속성이 빈 컬렉션으로 설정된 경우에도 WU_E_NO_UPDATE 반환합니다.

이 메서드는 다운로드 작업에 업데이트가 없는 경우 SUS_E_NOT_INITIALIZED 반환합니다.

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 11 빌드 26100
헤더	wuapi.h