Метод ISyncMgrControl::UpdateHandler (syncmgr.h)
Указывает центру синхронизации повторно определить элементы, управляемые обработчиком, или сообщает ему, что свойства обработчика изменились.
Синтаксис
HRESULT UpdateHandler(
[in] LPCWSTR pszHandlerID,
[in] SYNCMGR_CONTROL_FLAGS nControlFlags
);
Параметры
[in] pszHandlerID
Тип: LPCWSTR
Указатель на буфер, содержащий уникальный идентификатор обработчика. Эта строка имеет максимальную длину MAX_SYNCMGR_ID включая завершающий символ NULL .
[in] nControlFlags
Значение из перечисления SYNCMGR_CONTROL_FLAGS , указывающее, следует ли выполнять обновление синхронно или асинхронно.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Если SYNCMGR_CF_WAIT задано в параметре nControlFlags , UpdateHandler не возвращается, пока центр синхронизации не загрузит указанный обработчик и не перезагрузит все сведения об обработчике и элементе. Если обработчик предоставляется коллекцией обработчиков, коллекция обработчиков также загружается для перезагрузки обработчика.
Примеры
В следующем примере показано использование ISyncMgrControl::UpdateHandler процедурой обработчика.
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();
}
...
}
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
Целевая платформа | Windows |
Header | syncmgr.h |