Metode ISyncMgrControl::ActivateHandler (syncmgr.h)
Mengaktifkan atau menonaktifkan handler.
Sintaks
HRESULT ActivateHandler(
[in] BOOL fActivate,
[in] LPCWSTR pszHandlerID,
[in] HWND hwndOwner,
[in] SYNCMGR_CONTROL_FLAGS nControlFlags
);
Parameter
[in] fActivate
Jenis: BOOL
TRUE untuk diaktifkan; FALSE untuk dinonaktifkan.
[in] pszHandlerID
Jenis: LPCWSTR
Penunjuk ke buffer yang berisi ID unik handler. String ini memiliki panjang maksimum MAX_SYNCMGR_ID termasuk karakter null yang mengakhiri.
[in] hwndOwner
Jenis: HWND
Handel ke jendela yang dapat digunakan oleh handler untuk menampilkan UI yang diperlukan. Nilai ini bisa NULL.
[in] nControlFlags
Jenis: SYNCMGR_CONTROL_FLAGS
Nilai dari enumerasi SYNCMGR_CONTROL_FLAGS yang menentukan apakah aktivasi atau penonaktifan handler harus dilakukan secara sinkron atau asinkron.
Mengembalikan 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; handler tidak aktif muncul di folder Penyiapan Sinkronisasi.
Jika handler yang ditentukan mengembalikan SYNCMGR_HCM_QUERY_BEFORE_ACTIVATE atau SYNCMGR_HCM_QUERY_BEFORE_DEACTIVATE dalam masker yang dikembalikan dari metode GetCapabilities , operasi kueri diminta sebelum handler diaktifkan atau dinonaktifkan. Jika tidak ada antarmuka pengguna kueri yang diminta atau setelah pengguna mengonfirmasi operasi, metode Aktifkan handler akan dipanggil.
Jika SYNCMGR_CF_WAIT diatur dalam parameter nControlFlags , ActivateHandler tidak kembali hingga Sync Center memproses pemberitahuan ini.
Contoh
Contoh berikut menunjukkan penggunaan ISyncMgrControl::ActivateHandler dengan prosedur handler.
void MiscProc(...)
{
...
// Get the Sync Center control object.
ISyncMgrControl *pControl = NULL;
hr = CoCreateInstance(CLSID_SyncMgrControl,
CLSCTX_SERVER,
IID_PPV_ARGS(&pControl));
if (SUCCEEDED(hr))
{
// Tell Sync Center to activate our handler.
hr = pControl->ActivateHandler(TRUE,
s_szMySyncHandlerID,
hwndOwner,
SYNCMGR_CF_NOWAIT);
pControl->Release();
}
...
}
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 |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk