Metode ISyncMgrControl::UpdateConflicts (syncmgr.h)

Artikel
03/02/2024

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

Sintaks

HRESULT UpdateConflicts(
  [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.

Nilai kembali

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 , UpdateConflicts tidak kembali hingga Sync Center memuat handler yang ditentukan, mengambil penyimpanan konflik handler, dan memuat ulang semua konflik 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 conflicts 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 conflict
        // occurred on the handler rather than a specific item.
        hr = pControl->UpdateConflicts(s_szMyDeviceSyncHandlerID, 
                                       NULL,
                                       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

Bagikan melalui