Функция 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 , поставщик синхронизации может сообщать о ходе выполнения фильтру, тем самым сбрасывая 60-секундный период времени ожидания, соответствующий обратному вызову CF_CALLBACK_TYPE_FETCH_DATA. Это также сделает ход выполнения более плавным.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10, версия 1709 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Целевая платформа	Windows
Header	cfapi.h
Библиотека	CldApi.lib
DLL	CldApi.dll

См. также раздел

CfReportProviderProgress2

CF_CALLBACK_TYPE