Metode ISyncMgrControl::UpdateHandler (syncmgr.h)

Artikel
03/04/2024

Menginstruksikan Pusat Sinkronisasi untuk menghitung ulang item yang dikelola oleh handler atau memberi tahu bahwa properti handler telah berubah.

Sintaks

HRESULT UpdateHandler(
  [in] LPCWSTR               pszHandlerID,
  [in] SYNCMGR_CONTROL_FLAGS nControlFlags
);

Parameter

[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] nControlFlags

Jenis: SYNCMGR_CONTROL_FLAGS

Nilai dari enumerasi SYNCMGR_CONTROL_FLAGS yang menentukan apakah pembaruan harus dilakukan secara sinkron atau asinkron.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Jika SYNCMGR_CF_WAIT diatur dalam parameter nControlFlags , UpdateHandler tidak kembali hingga Sync Center memuat handler yang ditentukan dan memuat ulang semua informasi handler dan item. Jika handler disediakan oleh koleksi handler, koleksi handler juga dimuat untuk memuat ulang handler.

Contoh

Contoh berikut menunjukkan penggunaan ISyncMgrControl::UpdateHandler dengan prosedur handler.

void CMyDeviceHandler::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 that properties on the handler have changed.
        hr = pControl->UpdateHandler(s_szMySyncHandlerID, SYNCMGR_CF_WAIT);
        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

Bagikan melalui