ISyncMgrHandler::Aktifkan metode (syncmgr.h)

Meminta agar handler diaktifkan atau dinonaktifkan. Handler aktif dapat disinkronkan; handler tidak aktif tidak dapat.

Sintaks

HRESULT Activate(
  [in] BOOL fActivate
);

Parameter

[in] fActivate

Jenis: BOOL

TRUE untuk diaktifkan; FALSE untuk dinonaktifkan.

Menampilkan nilai

Jenis: HRESULT

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

Keterangan

Handler aktif muncul di folder Pusat Sinkronisasi dan dapat disinkronkan. Handler tidak aktif muncul di folder Penyiapan Sinkronisasi dan harus diaktifkan (yang memindahkannya ke folder Pusat Sinkronisasi) sebelum dapat disinkronkan.

Status aktivasi tidak boleh dikacaukan dengan status diaktifkan. Handler aktif dapat dinonaktifkan. Ini berarti masih ditampilkan di folder Pusat Sinkronisasi tetapi tidak dapat disinkronkan.

Sync Center memanggil metode ini dalam dua instans berikut.

• Saat pengguna memilih handler di folder Penyiapan Sinkronisasi dan meluncurkan tugas Penyetelannya . Jika handler mendukung objek SYNCMGR_OBJECTID_QueryBeforeActivate , metode ini hanya dipanggil jika operasi UI, yang terdiri dari dialog yang meminta pengguna untuk mengonfirmasi apakah mereka ingin mengaktifkan handler, berhasil.
• Saat pengguna memilih handler di folder Pusat Sinkronisasi dan meluncurkan tugas Hapus , tetapi hanya jika handler belum mengatur bendera SYNCMGR_HPM_PREVENT_DEACTIVATE . Jika handler mendukung objek SYNCMGR_OBJECTID_QueryBeforeDeactivate , metode ini hanya dipanggil jika operasi UI berhasil.

Jika bendera SYNCMGR_HPM_PREVENT_ACTIVATE diatur dalam nilai yang diambil oleh ISyncMgrHandler::GetCapabilities, panggilan ke metode ini yang meminta aktivasi handler akan gagal.

Status aktivasi handler individual dapat ditemukan dengan memanggil IsActive.

Jika handler tidak perlu melakukan tindakan apa pun saat diaktifkan, handler dapat mengembalikan S_OK atau E_NOTIMPL seperti yang ditunjukkan pada contoh di bawah ini.

Contoh

Contoh berikut menunjukkan implementasi sederhana dari metode ini.

STDMETHODIMP CMyDeviceHandler::Activate(__in BOOL fActivate)
{
    return E_NOTIMPL;
}

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

Lihat juga

ISyncMgrHandler

ISyncMgrHandler::GetObject

ISyncMgrUIOperation::Run