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 秒逾時期間。 這也會讓進度更順暢。

規格需求

另請參閱

CfReportProviderProgress2

CF_CALLBACK_TYPE