Поделиться через

Метод ISyncMgrControl::StartItemSync (syncmgr.h)

  • Статья

Инициирует синхронизацию указанных элементов, управляемых определенным обработчиком.

Синтаксис

HRESULT StartItemSync(
  [in] LPCWSTR                    pszHandlerID,
  [in] LPCWSTR                    *ppszItemIDs,
  [in] ULONG                      cItems,
  [in] HWND                       hwndOwner,
  [in] IUnknown                   *punk,
  [in] SYNCMGR_SYNC_CONTROL_FLAGS nSyncControlFlags,
  [in] ISyncMgrSyncResult         *pResult
);

Параметры

[in] pszHandlerID

Тип: LPCWSTR

Указатель на буфер, содержащий уникальный идентификатор обработчика, который управляет элементами. Эта строка имеет максимальную длину MAX_SYNCMGR_ID включая завершающий символ NULL .

[in] ppszItemIDs

Тип: LPCWSTR*

Адрес указателя на буфер, содержащий массив идентификаторов синхронизируемых элементов. Каждый идентификатор имеет максимальную длину MAX_SYNCMGR_ID включая завершающий символ NULL . Этот массив передается в synchronize.

[in] cItems

Тип: DWORD

Число идентификаторов в ppszItemID.

[in] hwndOwner

Тип: HWND

Дескриптор окна, который элемент может использовать для отображения любого необходимого пользовательского интерфейса. Это значение может иметь значение NULL.

[in] punk

Тип: IUnknown*

Указатель на объект IUnknown , передаваемый в synchronize. Этот параметр может принимать значение NULL.

[in] nSyncControlFlags

Тип: SYNCMGR_SYNC_CONTROL_FLAGS

Член перечисления SYNCMGR_SYNC_CONTROL_FLAGS , который указывает, следует ли повторно синхронизировать элемент, найденный как в текущей синхронизации, так и в синхронизации в очереди при выполнении синхронизации в очереди.

[in] pResult

Тип: ISyncMgrSyncResult*

Указатель на экземпляр ISyncMgrSyncResult, метод Result которого вызывается при завершении синхронизации в результате успешного выполнения, сбоя или отмены. Метод Result вызывается с агрегированным состоянием синхронизации обработчика. Этот параметр может принимать значение NULL.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод аналогиен UpdateItems.

Примеры

В следующем примере показано использование ISyncMgrControl::StartItemSync процедурой обработчика.

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))
    {
        // Synchronize one sync item for the sync handler.
        hr = pControl->StartItemSync(s_szMySyncHandlerID,
                                     s_szMySyncHandlerMusicContentID,
                                     1,
                                     _hwnd,
                                     NULL,
                                     NULL);
        pControl->Release();
    }

    ...

}

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header syncmgr.h