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

Метод ISyncMgrSessionCreator::CreateSession (syncmgr.h)

  • Статья

Уведомляет Центр синхронизации о начале синхронизации указанных элементов.

Синтаксис

HRESULT CreateSession(
  [in] LPCWSTR              pszHandlerID,
  [in] LPCWSTR              *ppszItemIDs,
  [in] ULONG                cItems,
  [in] ISyncMgrSyncCallback **ppCallback
);

Параметры

[in] pszHandlerID

Тип: LPCWSTR

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

[in] ppszItemIDs

Тип: LPCWSTR*

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

[in] cItems

Тип: ULONG

Количество идентификаторов элементов, содержащихся в буфере, на которые ссылается ppszItemIDs.

[in] ppCallback

Тип: ISyncMgrSyncCallback**

Адрес указателя на экземпляр ISyncMgrSyncCallback , используемый для отчета о ходе выполнения и событиях. Если обратный вызов не требуется, это значение может иметь значение NULL .

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

Тип: HRESULT

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

Комментарии

Необходимо указать как pszHandlerID , так и ppszItemIDs .

Примеры

В следующем примере показана структура реализации этого метода.

STDMETHODIMP CMyDeviceHandler::Synchronize(...)
{
    ...
    ISyncMgrSyncCallback *pCallback = NULL;

    hr = pCreator->CreateSession(_pszHandlerID, ppszItemIDs, cItems, &pCallback);
    if (SUCCEEDED(hr))
    {
        // Perform synchronization.
    }

    return hr;
}

Требования

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