Bagikan melalui

Antarmuka ISyncMgrUIOperation (syncmgr.h)

  • Artikel

Mengekspos metode di mana handler sinkronisasi atau item sinkronisasi dapat menampilkan objek UI ketika diminta untuk melakukannya oleh Sync Center.

Warisan

Antarmuka ISyncMgrUIOperation mewarisi dari antarmuka IUnknown . ISyncMgrUIOperation juga memiliki jenis anggota ini:

Metode

Antarmuka ISyncMgrUIOperation memiliki metode ini.

 
ISyncMgrUIOperation::Run

Melakukan tampilan UI aktual untuk handler atau item sinkronisasi saat diminta untuk melakukannya oleh Sync Center.

Keterangan

Handler menerapkan ISyncMgrUIOperation untuk menyediakan UI untuk tindakan tertentu. Setiap tindakan terpisah (telusuri, jadwalkan, aktifkan/nonaktifkan, aktifkan/nonaktifkan, dan hapus) memerlukan implementasi terpisah.

Handler hanya boleh mengimplementasikan antarmuka ini untuk operasi yang ingin disajikan UI.

Berikut ini meringkas langkah-langkah yang diperlukan Sync Center untuk membuat instans dan menggunakan antarmuka ini.

  1. Sync Center membuat utas terpisah untuk operasi UI.
  2. Sync Center membuat instans baru handler.
  3. Jika operasi hanya melibatkan handler, Sync Center memanggil ISyncMgrHandler::GetObject dengan ID objek SYNCMGR_OBJECTID yang sesuai untuk mendapatkan pointer ke ISyncMgrUIOperation yang mengimplementasikan objek UI tersebut. Misalnya, Sync Center memanggil ISyncMgrHandler::GetObject dengan SYNCMGR_OBJECTID_QueryBeforeDelete untuk mendapatkan objek yang dipanggil untuk menampilkan UI ketika pengguna memilih untuk menghapus handler, meminta konfirmasi bahwa mereka memang ingin menghapusnya.
  4. Jika operasi melibatkan item sinkronisasi, Sync Center melakukan serangkaian panggilan, termasuk yang berikut ini:
    1. QueryInterface dipanggil pada antarmuka ISyncMgrHandler untuk mengambil instans ISyncMgrSyncItemContainer.
    2. ISyncMgrSyncItemContainer::GetSyncItem dipanggil untuk mendapatkan pointer ke instans ISyncMgrSyncItem yang mewakili item.
    3. ISyncMgrSyncItem::GetObject dipanggil dengan ID objek SYNCMGR_OBJECTID yang sesuai untuk mendapatkan pointer ke ISyncMgrUIOperation yang mengimplementasikan objek UI.
  5. Sync Center memanggil metode Jalankan objek UI untuk menampilkan UI.
Dengan menerapkan UI sebagai antarmuka terpisah, tampilan UI dapat dilakukan secara independen dari sinkronisasi. ISyncMgrUIOperation harus diimplementasikan pada objek yang berbeda dari ISyncMgrHandler atau ISyncMgrSyncItem.

Jika pengguna meminta tindakan, maka meminta tindakan yang sama lagi sebelum yang pertama selesai, UI untuk tindakan awal diaktifkan dan dibawa ke latar depan.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header syncmgr.h