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 포함) |