IFileOperationProgressSink::UpdateProgress 메서드(shobjidl_core.h)

총 작업량과 관련하여 현재 수행된 총 작업량의 추정치를 제공합니다.

구문

HRESULT UpdateProgress(
  [in] UINT iWorkTotal,
  [in] UINT iWorkSoFar
);

매개 변수

[in] iWorkTotal

형식: UINT

완료할 작업의 예상 작업량입니다.

[in] iWorkSoFar

형식: UINT

지금까지 완료된 iWorkTotal 의 부분입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

iWorkTotal 및 iWorkSoFar 값은 "포인트" 또는 수행할 작업량과 완료된 작업의 예상값입니다. 특정 단위로 지정되지는 않지만 총 프로세스에 소요되는 시간에 거의 비례해야 합니다. 예를 들어 하나의 작은 파일을 복사하려면 두 개의 지점으로 간주될 수 있으며 큰 파일은 10포인트로 간주될 수 있습니다. 프로세스가 5개의 작은 파일과 1개의 큰 파일을 복사하는 작업을 수행하고 프로세스가 작은 파일 중 4개를 완료한 경우 iWorkSoFar 는 8포인트(4 x 2 = 8)이 되고 iWorkTotal 은 20포인트(5 x 2 + 10 = 20)가 되므로 20점 중 8점(또는 40%)이 완료됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)