Fungsi CfDisconnectSyncRoot (cfapi.h)

Memutuskan sambungan saluran komunikasi yang dibuat oleh CfConnectSyncRoot.

Sintaks

HRESULT CfDisconnectSyncRoot(
  [in] CF_CONNECTION_KEY ConnectionKey
);

Parameter

[in] ConnectionKey

Kunci koneksi yang dikembalikan dari CfConnectSyncRoot yang sekarang digunakan untuk memutuskan akar sinkronisasi.

Nilai kembali

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

Keterangan

Ini menghapus saluran komunikasi dengan platform yang sebelumnya dibuat menggunakan CfConnectSyncRoot.

Penyedia sinkronisasi masih dapat menerima panggilan balik selama panggilan CfDisconnectSyncRoot , dan penyedia bebas untuk memilih apakah panggilan perlu gagal atau dilayankan. Salah satu pilihan tidak akan menyebabkan gangguan pada penyedia sinkronisasi.

Setelah panggilan ke CfDisconnectSyncRoot kembali, penyedia sinkronisasi tidak akan lagi menerima panggilan balik dan platform akan gagal operasi apa pun yang bergantung pada panggilan balik tersebut.

Penyedia sinkronisasi harus memiliki akses WRITE_DATA atau WRITE_DAC ke akar sinkronisasi yang akan terputus atau panggilan ke CfDisconnectSyncRoot akan gagal dengan HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED). Selain itu, jika akar sinkronisasi belum tersambung sebelumnya, panggilan akan gagal dengan parameter yang tidak valid. API ini dapat dipanggil sebagai bagian dari mematikan penyedia sinkronisasi dengan lancar. Namun, jika proses penyedia sinkronisasi memilih untuk mengakhiri tanpa memanggil API ini, atau secara tak terduga crash, platform akan mendeteksi ini dan melakukan pembersihan yang diperlukan.

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

CfConnectSyncRoot