Metode ISyncMgrControl::UpdateEvents (syncmgr.h)

Artikel
08/26/2023

Menginformasikan Pusat Sinkronisasi bahwa peristiwa telah ditambahkan untuk handler atau item tertentu.

Sintaks

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

Parameter

[in] pszHandlerID

Jenis: LPCWSTR

Penunjuk ke buffer yang berisi ID unik handler yang mengelola item. String ini memiliki panjang maksimum MAX_SYNCMGR_ID termasuk karakter null yang mengakhiri.

[in] pszItemID

Jenis: LPCWSTR

Penunjuk ke buffer yang berisi ID unik item. String ini memiliki panjang maksimum MAX_SYNCMGR_ID termasuk karakter null yang mengakhiri. Parameter ini dapat berupa NULL jika peristiwa terjadi pada handler daripada pada item tertentu.

[in] nControlFlags

Jenis: SYNCMGR_CONTROL_FLAGS

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

Menampilkan nilai

Jenis: HRESULT

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

Keterangan

Jika SYNCMGR_CF_WAIT diatur dalam parameter nControlFlags , UpdateEvents tidak kembali hingga Sync Center memuat handler yang ditentukan, mengambil penyimpanan peristiwa handler, dan memuat ulang semua peristiwa dari penyimpanan tersebut. Jika handler disediakan oleh koleksi handler, koleksi handler juga dimuat untuk memuat ulang handler.

Contoh

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

void CMyDeviceHandler::Synchronize(...)
{
    ...
    // Add events to the event store.

    // 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 we added events to our event store.
        // By passing NULL in pszItemID, we tell Sync Center that the event
        // occurred on the handler rather than a specific item.
        hr = pControl->UpdateEvents(s_szMyDeviceSyncHandlerID, 
                                    NULL,
                                    SYNCMGR_CF_NOWAIT);
        pControl->Release();
    }

    ...

}

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

Bagikan melalui