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

작업의 진행률을 UI에 업데이트.

구문

HRESULT UpdateProgress(
  [in] ULONGLONG ulCompleted,
  [in] ULONGLONG ulTotal
);

매개 변수

[in] ulCompleted

형식: ULONGLONG

완료된 작업의 양입니다.

[in] ulTotal

형식: ULONGLONG

작업의 총 크기입니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하거나, 그렇지 않으면 오류 값을 반환합니다.

설명

작업의 진행률을 업데이트하려면 이 메서드를 주기적으로 호출해야 합니다. ulCompleted 및 ulTotal 값은 의미 있는 진행률을 결정하기 위해 서로 상대적으로 해석되어야 하지만 구현 클래스는 원하는 방식으로 이러한 값을 해석할 수 있습니다. 백분율이 필요한 경우가 많으며, 이 경우 ulCompleted 값을 ulTotal로 나누고 결과를 값 100으로 곱해야 합니다.

요구 사항

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