Metode ISyncMgrControl::UpdateItem (syncmgr.h)

Menginformasikan Pusat Sinkronisasi bahwa properti item sinkronisasi telah berubah.

Sintaks

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

[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 , UpdateItem 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::UpdateItem 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 of the item have changed.
        hr = pControl->UpdateItem(s_szMySyncHandlerID,
                                  s_szMySyncHandlerMusicContentID,
                                  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