IProgressNotify::OnProgress 메서드(objidl.h)

등록된 개체 및 애플리케이션에 다운로드 작업의 진행률을 알 수 있습니다.

구문

HRESULT OnProgress(
  [in] DWORD dwProgressCurrent,
  [in] DWORD dwProgressMaximum,
  [in] BOOL  fAccurate,
  [in] BOOL  fOwner
);

매개 변수

[in] dwProgressCurrent

사용 가능한 데이터의 양입니다.

[in] dwProgressMaximum

다운로드할 총 데이터 양입니다.

[in] fAccurate

dwProgressCurrent 및 dwProgressMaximum의 값 정확도를 나타냅니다. 신뢰할 수 있는(TRUE) 또는 신뢰할 수 없음(FALSE)입니다. FALSE 값은 아직 다운로드할 데이터의 실제 위치 또는 양을 결정하기 위한 제어 구조를 사용할 수 없음을 나타냅니다.

[in] fOwner

이 OnProgress 호출이 작업의 차단 동작을 제어할 수 있는지 여부를 나타냅니다. TRUE이면 호출자는 OnProgress의 반환 값을 사용하여 작업을 차단(STG_S_BLOCK), 다시 시도(STG_S_RETRYNOW) 또는 모니터링(STG_S_MONITORING)할 수 있습니다. FALSE이면 OnProgress의 반환 값이 차단 동작에 영향을 주지 않습니다.

반환 값

이 메서드는 다음 값뿐만 아니라 E_FAIL, E_INVALIDARG, E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값을 반환할 수 있습니다.

설명

싱크는 지정된 스토리지의 하위 저장소 또는 하위 스트림에서 상속될 수 있습니다. 싱크가 등록되지 않은 경우 요청된 데이터를 사용할 수 있게 되거나 다운로드자가 다운로드를 취소할 때까지 스레드가 차단됩니다.

여러 개체 또는 애플리케이션이 단일 스트림에 진행률 알림 싱크를 등록한 경우 그 중 하나만 다운로드 동작을 제어할 수 있습니다. 다운로드 소유권은 첫 번째 싱크로 이동하여 스토리지 또는 스트림에 등록하거나 부모 스토리지에서 상속되었을 수 있는 조언 스킨(ASYNC_MODE_COMPATIBILITY 사용하여 스토리지를 만든 경우)으로 이동합니다.

싱크 중 하나는 현재 호출자를 만드는 연결 지점에 STG_S_MONITORING 반환하여 다음 연결 지점으로 제어를 포기할 수 있습니다. 연결점이 STG_S_BLOCK 또는 STG_S_RETRYNOW 수신을 통해 제어를 가져온 후 OnProgress 를 호출하는 모든 후속 연결 지점은 fOwner 를 FALSE로 설정합니다.

요구 사항

추가 정보

IProgressNotify