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

UI에서 전송 진행률 상태 업데이트.

구문

HRESULT UpdateProgress(
  [in] ULONGLONG ullSizeCurrent,
  [in] ULONGLONG ullSizeTotal,
  [in] int       nFilesCurrent,
  [in] int       nFilesTotal,
  [in] int       nFoldersCurrent,
  [in] int       nFoldersTotal
);

매개 변수

[in] ullSizeCurrent

형식: ULONGLONG

현재 작업에서 처리된 바이트 수입니다.

[in] ullSizeTotal

형식: ULONGLONG

현재 작업의 총 바이트 수입니다.

[in] nFilesCurrent

형식: int

현재 작업에서 처리된 파일 수입니다.

[in] nFilesTotal

형식: int

작업의 총 파일 수입니다. 이 메서드에 대한 마지막 호출 이후 값이 변경되지 않았음을 나타내려면 0으로 설정합니다.

[in] nFoldersCurrent

형식: int

현재 작업에서 처리된 폴더 수입니다.

[in] nFoldersTotal

형식: int

작업의 총 폴더 수입니다. 이 메서드에 대한 마지막 호출 이후 값이 변경되지 않았음을 나타내려면 0으로 설정합니다.

반환 값

형식: HRESULT

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

설명

이 메서드에 대한 마지막 호출 이후 합계가 변경되지 않았음을 나타내려면 ullSizeTotal, nFilesTotal 및 nFoldersTotal 을 모두 0으로 설정합니다.

이 메서드에 대한 마지막 호출 이후 진행률이 변경되지 않았음을 나타내려면 6개의 매개 변수를 모두 0으로 설정합니다.

구현자에 대한 참고 사항

이 함수의 구현자는 사용자가 취소 단추를 클릭하는 경우와 같이 작업이 완료되기 전에 종료해야 하는 경우 오류 코드를 반환해야 합니다.

요구 사항

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