Fungsi CfReportSyncStatus (cfapi.h)

Memungkinkan penyedia sinkronisasi untuk memberi tahu platform statusnya pada akar sinkronisasi tertentu tanpa harus terhubung dengan panggilan ke CfConnectSyncRoot terlebih dahulu.

Sintaks

HRESULT CfReportSyncStatus(
  [in, out] LPCWSTR        SyncRootPath,
  [in]      CF_SYNC_STATUS *SyncStatus
);

Parameter

[in, out] SyncRootPath

Jalur ke akar sinkronisasi.

[in] SyncStatus

Status sinkronisasi untuk dilaporkan; jika NULL, menghapus status sinkronisasi yang disimpan sebelumnya. Untuk informasi selengkapnya, lihat bagian Keterangan , di bawah ini.

Menampilkan nilai

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

Keterangan

Ketika CF_SYNC_STATUS non-null disediakan dalam parameter SyncStatus , informasi akan diingat pada akar sinkronisasi sampai dibersihkan secara eksplisit oleh penyedia sinkronisasi atau ketika mesin di-boot ulang. Platform ini akan mengkueri informasi ini setelah operasi yang gagal pada tempat penampung file cloud, menggunakan proses berikut:

1. Platform pertama-tama akan mencari status sinkronisasi di tingkat file.
2. Jika tidak ada status sinkronisasi yang ditemukan, platform kemudian akan mencari status sinkronisasi yang terdaftar di tingkat akar sinkronisasi, yang dilakukan melalui fungsi ini.
3. Setelah status sinkronisasi berada, platform akan menggunakan informasi yang disediakan untuk membuat pesan yang lebih bermakna dan dapat ditindak lanjuti kepada pengguna.

CfReportSyncStatus menghapus status sinkronisasi yang disimpan sebelumnya saat dipanggil dengan NULL status sinkronisasi. Tidak ada perubahan yang akan dilakukan pada status sinkronisasi yang ada jika panggilan fungsi gagal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1803 [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

CfConnectSyncRoot

CF_SYNC_STATUS