Fungsi CfUnregisterSyncRoot (cfapi.h)

Membatalkan pendaftaran akar sinkronisasi yang didaftarkan sebelumnya.

Sintaks

HRESULT CfUnregisterSyncRoot(
  [in] LPCWSTR SyncRootPath
);

Parameter

[in] SyncRootPath

Jalur ke akar sinkronisasi yang akan dibatalkan pendaftarannya.

Mengembalikan nilai

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

Keterangan

Membatalkan pendaftaran akar sinkronisasi yang terdaftar di CfRegisterSyncRoot. Ini biasanya dipanggil pada waktu penghapusan instalan penyedia sinkronisasi, ketika akun pengguna dihapus, atau ketika pengguna memilih untuk tidak lagi menyinkronkan pohon direktori (jika didukung oleh penyedia sinkronisasi). Jika akar sinkronisasi yang tidak terdaftar belum pernah didaftarkan sebelumnya, API gagal dengan STATUS_CLOUD_FILE_NOT_UNDER_SYNC_ROOT.

Penyedia sinkronisasi harus memiliki akses WRITE_DATA atau WRITE_DAC ke akar sinkronisasi untuk tidak terdaftar, atau tidak terdaftar akan gagal dengan HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED). Pembatasan registrasi juga akan gagal dengan HRESULT(ERROR_CLOUD_FILE_INVALID_REQUEST) jika penyedia sinkronisasi terhubung ke akar sinkronisasi.

Membatalkan pendaftaran akar sinkronisasi dengan melintas pohon direktori akar sinkronisasi.

Untuk file tempat penampung:

• Jika file tempat penampung sepenuhnya terhidrasi, file tersebut dikembalikan ke file "normal".
• Jika file tempat penampung tidak terhidrasi, file tersebut akan dihapus secara permanen dari komputer lokal.

Untuk direktori tempat penampung:

• Jika direktori tempat penampung diisi sepenuhnya, direktori tersebut dikembalikan ke direktori "normal".
• Jika direktori tempat penampung tidak sepenuhnya diisi, direktori akan dihapus secara permanen dari komputer lokal.

Catatan

Jika file atau direktori tempat penampung tidak dapat dikembalikan atau dihapus, file atau direktori akan dilewati, dan proses pembatalan pendaftaran akan berlanjut sampai pohon akar sinkronisasi penuh telah dilalui.

Persyaratan

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

CfRegisterSyncRoot