ISyncMgrSyncItem::Aktifkan metode (syncmgr.h)

Artikel
03/13/2024

Mengaktifkan atau menonaktifkan item sinkronisasi.

Sintaks

HRESULT Enable(
  [in] BOOL fEnable
);

Parameter

[in] fEnable

Jenis: BOOL

TRUE untuk mengaktifkan; FALSE untuk dinonaktifkan.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Pusat Sinkronisasi memanggil metode ini dalam skenario berikut.

Saat pengguna memilih item di folder handler dan meluncurkan tugas Aktifkan , tetapi hanya jika item belum mengatur bendera SYNCMGR_IPM_PREVENT_ENABLE . Jika handler mendukung objek SYNCMGR_OBJECTID_QueryBeforeEnable , metode ini hanya dipanggil jika operasi UI berhasil.
Saat pengguna memilih item di folder handler dan meluncurkan tugas Nonaktifkan , tetapi hanya jika item belum mengatur bendera SYNCMGR_IPM_PREVENT_DISABLE . 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 CMyDeviceSyncItem::Enable(__in BOOL fEnable)
{
    return E_NOTIMPL;
}

Persyaratan

Persyaratan	Nilai
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

Bagikan melalui