다음을 통해 공유

IControlProgressHandler

  • 아티클

이 인터페이스는 라이브러리가 작업을 수행할 때 업데이트를 수신하는 클라이언트 쪽 처리기입니다. 그런 다음 라이브러리는 작업의 진행률을 나타내는 클라이언트에 대한 동기 콜백을 실행합니다. 사용자 작업에 따라 클라이언트 반환 코드는 라이브러리에 작업을 계속하거나 취소하도록 지시합니다. 이 프로세스를 통해 UI는 저장과 같은 긴 작업의 진행률을 사용자에게 표시할 수 있습니다. 사용자가 작업을 취소하도록 선택하면 UI는 해당 코드를 라이브러리에 반환합니다.

Syntax

{
  [id(1), helpstring("OnBegin")] HRESULT OnBegin();
  [id(2), helpstring("OnUpdate")] HRESULT OnUpdate
    ([in] ULONG CurrentValuePercent);
  [id(3), helpstring("OnEnd")] HRESULT OnEnd
    ([in] HRESULT hrResult);
};

Functions

다음 표에서는 이 인터페이스가 제공하는 함수에 대해 설명합니다.

함수 설명

OnBegin

라이브러리에 작업을 시작하도록 지시합니다.

OnUpdate

라이브러리에 작업의 진행을 계속하도록 지시합니다.

OnEnd

작업이 종료된 후 상태 코드를 반환합니다.

인터페이스