Fungsi CfReportProviderProgress (cfapi.h)

2024-02-26

Memungkinkan penyedia sinkronisasi melaporkan kemajuan di luar band.

Sintaks

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

Parameter

[in] ConnectionKey

Kunci koneksi yang mewakili saluran komunikasi dengan filter sinkronisasi.

[in] TransferKey

Handel buram ke tempat penampung.

[in] ProviderProgressTotal

Kemajuan total penyedia sinkronisasi sebagai respons terhadap pengambilan panggilan balik data.

[in] ProviderProgressCompleted

Kemajuan penyedia sinkronisasi yang telah selesai sebagai respons terhadap pengambilan panggilan balik data.

Menampilkan nilai

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Filter secara otomatis melacak kemajuan hidrasi, dengan melacak rentang yang ditransfer dan/atau diakui sebagai respons terhadap panggilan balik FETCH_DATA . Namun, jika penyedia menghabiskan sebagian besar waktunya untuk mengunduh konten ke lokasi sementara sebelum mulai TRANSFER_DATA ke filter, filter akan tidak menyadari bahwa aktivitas ini dengan cara apa pun terkait dengan permintaan.

Dengan memanggil CfReportProviderProgress secara berkala, penyedia sinkronisasi dapat melaporkan kemajuan ke filter, sehingga mengatur ulang periode batas waktu 60 detik yang sesuai dengan panggilan balik CF_CALLBACK_TYPE_FETCH_DATA . Ini juga akan membuat kemajuan tampak lebih lancar.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1709 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	cfapi.h
Pustaka	CldApi.lib
DLL	CldApi.dll

Lihat juga

CfReportProviderProgress2

CF_CALLBACK_TYPE

Bagikan melalui