Bagikan melalui

ISyncMgrSynchronize::Initialize method (mobsync.h)

  • Artikel

Dipanggil oleh manajer sinkronisasi dalam penangan aplikasi terdaftar untuk menentukan apakah handler memproses peristiwa sinkronisasi.

Sintaks

HRESULT Initialize(
  [in] DWORD      dwReserved,
  [in] DWORD      dwSyncMgrFlags,
  [in] DWORD      cbCookie,
  [in] const BYTE *lpCookie
);

Parameter

[in] dwReserved

Jenis: DWORD

Dipesan; harus 0 (nol).

[in] dwSyncMgrFlags

Jenis: DWORD

Nilai enumerasi SYNCMGRFLAG yang menjelaskan bagaimana peristiwa sinkronisasi dimulai.

[in] cbCookie

Jenis: DWORD

Ukuran data lpCookie , dalam byte.

[in] lpCookie

Jenis: BYTE const*

Penunjuk ke token yang mengidentifikasi aplikasi. Token ini diteruskan ketika aplikasi memanggil manajer sinkronisasi secara terprogram.

Menampilkan nilai

Jenis: HRESULT

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

Menampilkan kode Deskripsi
S_OK
 Inisialisasi berhasil.
S_FALSE
 Handler aplikasi tidak memproses peristiwa sinkronisasi.

Keterangan

Nilai enumerasi SYNCMGRFLAG berlaku selama masa pakai antarmuka ISyncMgrSynchronize , dan digunakan oleh metode ISyncMgrSynchronize lainnya.

Jika aplikasi tidak mengenali peristiwa SYNCMGRFLAG , aplikasi harus memperlakukan peristiwa sebagai sinkronisasi manual.

Handler aplikasi terdaftar tidak dapat menampilkan antarmuka pengguna dalam panggilan ini kecuali ini adalah pertama kalinya metode inisialisasi dipanggil. Aplikasi dapat menampilkan inisialisasi satu kali yang diperlukan untuk menyiapkan item dan memperkenalkan pengguna ke fitur aplikasi. Jika Anda perlu menampilkan antarmuka pengguna karena alasan yang berbeda sebagai bagian dari proses sinkronisasi, Anda dapat menggunakan metode ISyncMgrSynchronize::P repareForSync .

Parameter lpCookie adalah NULL kecuali aplikasi penanganan memanggil manajer sinkronisasi secara terprogram dengan menggunakan UpdateItems. Dalam skenario ini, pengidentifikasi kelas (CLSID) mengidentifikasi aplikasi penanganan, dan nilai lpCookie diteruskan oleh aplikasi penanganan, dan kemudian diteruskan kembali oleh manajer sinkronisasi selama sinkronisasi untuk konteks. Parameter lpCookie hanya bermakna ketika SYNCMGRFLAG_INVOKE diatur.

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

Lihat juga

ISyncMgrSynchronize

ISyncMgrSynchronize::P repareForSync

SYNCMGRFLAG

UpdateItems