ISyncMgrSynchronize::Synchronize method (mobsync.h)

Artikel
08/24/2023

Dipanggil oleh manajer sinkronisasi sekali untuk setiap grup yang dipilih setelah pengguna memilih aplikasi terdaftar untuk disinkronkan.

Sintaks

HRESULT Synchronize(
  [in] HWND hWndParent
);

Parameter

[in] hWndParent

Jenis: HWND

Handel ke HWND induk yang harus digunakan aplikasi terdaftar untuk elemen antarmuka pengguna apa pun yang ditampilkannya. Nilai ini mungkin NULL.

Menampilkan nilai

Jenis: HRESULT

Metode ini mendukung nilai pengembalian standar, E_INVALIDARG, E_UNEXPECTED, dan E_OUTOFMEMORY, serta berikut ini:

Menampilkan kode	Deskripsi
S_OK	Sinkronisasi berhasil.
E_FAIL	Sinkronisasi gagal.

Keterangan

Jika pengguna tidak memilih pilihan item apa pun untuk aplikasi terdaftar, metode ISyncMgrSynchronize::Synchronize tidak dipanggil dan antarmuka dirilis. Jika metode ini dipanggil, aplikasi harus menyinkronkan item yang ditentukan dalam metode ISyncMgrSynchronize::P repareForSync .

Handler aplikasi terdaftar harus kembali dari metode ISyncMgrSynchronize::Synchronize sesegera mungkin dan kemudian memanggil metode SynchronizeCompleted . Handler dapat memanggil panggilan SynchronizeCompleted sebelum kembali dari metode ISyncMgrSynchronize::Synchronize .

Aplikasi harus memberikan umpan balik kemajuan dan memeriksa apakah sinkronisasi harus dibatalkan dengan menggunakan penunjuk antarmuka pSyncCallBack yang disiapkan di metode ISyncMgrSynchronize::SetProgressCallback .

Aplikasi harus memberikan informasi kemajuan meskipun bendera SYNCMGRFLAG_MAYBOTHERUSER tidak ditentukan dalam ISyncMgrSynchronize::Initialize.

Aplikasi harus mencoba untuk tidak menampilkan elemen antarmuka pengguna dari dalam metode ISyncMgrSynchronize::Synchronize . Setiap elemen antarmuka pengguna harus ditampilkan dalam metode ISyncMgrSynchronize::P repareForSync dan ISyncMgrSynchronize::ShowError sehingga pengguna akhir mengalami antarmuka pengguna yang konsisten yang terbatas pada masuk dan menentukan berbagi yang akan disinkronkan. Selanjutnya, sinkronisasi dapat dilakukan tanpa intervensi pengguna. Setelah sinkronisasi selesai, konflik atau pesan kesalahan lainnya dapat ditampilkan.

Metode ISyncMgrSynchronizeCallback dapat dipanggil pada utas apa pun di aplikasi Anda.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	mobsync.h
DLL	Mobsync.dll