ISyncMgrHandler::Aktifkan metode (syncmgr.h)

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

Sintaks

HRESULT Enable(
  [in] BOOL fEnable
);

Parameter

[in] fEnable

Jenis: BOOL

TRUE untuk mengaktifkan; 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 harus mengatur bendera SYNCMGR_HCM_CAN_ENABLE dan SYNCMGR_HCM_CAN_DISABLE agar entri Aktifkan dan Nonaktifkan muncul pada menu pintasan handler saat handler ditampilkan di folder Pusat Sinkronisasi. Memilih untuk mengaktifkan handler berarti dapat disinkronkan; memilih untuk menonaktifkan handler berarti tidak dapat.

Sync Center memanggil metode ini dalam dua instans berikut.

• Saat pengguna memilih handler di folder Pusat Sinkronisasi dan meluncurkan tugas Aktifkan . Jika handler mendukung objek SYNCMGR_OBJECTID_QueryBeforeEnable , metode ini hanya dipanggil jika operasi UI berhasil.
• Saat pengguna memilih handler di folder Pusat Sinkronisasi dan meluncurkan tugas Nonaktifkan . Jika handler mendukung objek SYNCMGR_OBJECTID_QueryBeforeDisable , metode ini hanya dipanggil jika operasi UI berhasil.

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::Enable(__in BOOL fEnable)
{
    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

IsEnabled