CfReportProviderProgress-Funktion (cfapi.h)

Ermöglicht es einem Synchronisierungsanbieter, Den Fortschritt out-of-Band zu melden.

Syntax

HRESULT CfReportProviderProgress(
  [in] CF_CONNECTION_KEY ConnectionKey,
  [in] CF_TRANSFER_KEY   TransferKey,
  [in] LARGE_INTEGER     ProviderProgressTotal,
  [in] LARGE_INTEGER     ProviderProgressCompleted
);

Parameter

[in] ConnectionKey

Ein Verbindungsschlüssel, der einen Kommunikationskanal mit dem Synchronisierungsfilter darstellt.

[in] TransferKey

Ein undurchsichtiges Handle für den Platzhalter.

[in] ProviderProgressTotal

Der Gesamtfortschritt des Synchronisierungsanbieters als Reaktion auf einen Abruf von Datenrückruf.

[in] ProviderProgressCompleted

Der abgeschlossene Fortschritt des Synchronisierungsanbieters als Reaktion auf einen Abruf von Datenrückruf.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird zurückgegeben S_OK. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Filter verfolgt automatisch den Fortschritt der Hydrationen nach, indem Bereiche nachverfolgt werden, die als Reaktion auf FETCH_DATA Rückrufe übertragen und/oder bestätigt werden. Wenn ein Anbieter jedoch den Größten Teil seiner Zeit damit verbringt, Inhalte an einen temporären Speicherort herunterzuladen, bevor er beginnt, in den Filter zu TRANSFER_DATA , ist sich der Filter andernfalls nicht bewusst, dass diese Aktivitäten in irgendeiner Weise mit der Anforderung zusammenhängen.

Durch regelmäßiges Aufrufen von CfReportProviderProgress kann der Synchronisierungsanbieter den Status an den Filter melden und dadurch den Timeoutzeitraum von 60 Sekunden zurücksetzen, der dem CF_CALLBACK_TYPE_FETCH_DATA Rückrufs entspricht. Dadurch wird auch der Fortschritt reibungsloser angezeigt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	cfapi.h
Bibliothek	CldApi.lib
DLL	CldApi.dll

Weitere Informationen

CfReportProviderProgress2

CF_CALLBACK_TYPE