CfReportProviderProgress 함수(cfapi.h)
동기화 공급자가 대역 외 진행률을 보고할 수 있습니다.
구문
HRESULT CfReportProviderProgress(
[in] CF_CONNECTION_KEY ConnectionKey,
[in] CF_TRANSFER_KEY TransferKey,
[in] LARGE_INTEGER ProviderProgressTotal,
[in] LARGE_INTEGER ProviderProgressCompleted
);
매개 변수
[in] ConnectionKey
동기화 필터를 사용하는 통신 채널을 나타내는 연결 키입니다.
[in] TransferKey
자리 표시자에 대한 불투명 핸들입니다.
[in] ProviderProgressTotal
페치 데이터 콜백에 대한 응답으로 동기화 공급자의 총 진행률입니다.
[in] ProviderProgressCompleted
페치 데이터 콜백에 대한 응답으로 동기화 공급자의 완료된 진행률입니다.
반환 값
이 함수가 성공하면 를 반환합니다 S_OK. 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
필터는 FETCH_DATA 콜백 에 대한 응답으로 전송 및/또는 승인되는 범위를 추적하여 수화의 진행률을 자동으로 추적합니다. 그러나 공급자가 필터에 TRANSFER_DATA 시작하기 전에 임시 위치에 콘텐츠를 다운로드하는 데 많은 시간을 소비하는 경우 필터는 이러한 활동이 요청과 어떤 식으로든 관련이 있다는 것을 인식하지 못합니다.
CfReportProviderProgress를 주기적으로 호출하면 동기화 공급자가 필터에 진행률을 보고하여 CF_CALLBACK_TYPE_FETCH_DATA 콜백에 해당하는 60초의 시간 제한 기간을 다시 설정할 수 있습니다. 이렇게 하면 진행률이 더 매끄럽게 표시됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1709 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | cfapi.h |
| 라이브러리 | CldApi.lib |
| DLL | CldApi.dll |