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 |