Metode ISyncMgrSynchronize::P repareForSync (mobsync.h)

Artikel
08/24/2023

Memungkinkan aplikasi terdaftar untuk menampilkan antarmuka pengguna apa pun, dan melakukan inisialisasi yang diperlukan sebelum metode ISyncMgrSynchronize::Synchronize dipanggil. Misalnya, aplikasi seperti klien email Microsoft Outlook mungkin perlu menampilkan kotak dialog kata sandi untuk memungkinkan pengguna masuk ke server email.

Sintaks

HRESULT PrepareForSync(
  [in] ULONG cbNumItems,
  [in] GUID  *pItemIDs,
  [in] HWND  hWndParent,
  [in] DWORD dwReserved
);

Parameter

[in] cbNumItems

Jenis: ULONG

Jumlah item dalam array yang ditujukkan oleh pItemID.

[in] pItemIDs

Jenis: GUID*

Array ID item yang dipilih pengguna untuk disinkronkan.

[in] hWndParent

Jenis: HWND

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

[in] dwReserved

Jenis: DWORD

Dicadangkan. Aplikasi terdaftar harus mengabaikan nilai ini.

Nilai kembali

Jenis: HRESULT

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

Menampilkan kode	Deskripsi
S_OK	Persiapan berhasil.

Keterangan

Handler aplikasi terdaftar harus kembali dari metode ini sesegera mungkin, dan kemudian memanggil metode PrepareForSyncCompleted . Handler aplikasi terdaftar dapat memanggil metode PrepareForSyncCompleted sebelum kembali dari metode ini.

Aplikasi terdaftar hanya boleh menampilkan antarmuka pengguna jika bendera SYNCMGRFLAG_MAYBOTHERUSER diatur dalam parameter dwSyncFlags dari metode ISyncMgrSynchronize::Initialize . Jika aplikasi terdaftar tidak dapat mempersiapkan sinkronisasi tanpa menampilkan antarmuka pengguna ketika bendera SYNCMGRFLAG_MAYBOTHERUSER tidak diatur, aplikasi harus mengembalikan S_FALSE dari metode ini.

Array ID item yang diteruskan ke metode ini relevan dengan metode ISyncMgrSynchronize::Synchronize juga.

Metode ISyncMgrSynchronizeCallback dapat dipanggil pada utas apa pun dalam aplikasi terdaftar.

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