Метод ISyncKnowledge::ConvertVersion (winsync.h)

Статья
08/27/2023

Преобразует версию из другого реплика в версию, совместимую с реплика, владеющей данными.

Синтаксис

HRESULT ConvertVersion(
  [in]      ISyncKnowledge     *pKnowledgeIn,
  [in]      const BYTE         *pbCurrentOwnerId,
  [in]      const SYNC_VERSION *pVersionIn,
  [in]      BYTE               *pbNewOwnerId,
  [in, out] DWORD              *pcbIdSize,
  [out]     SYNC_VERSION       *pVersionOut
);

Параметры

[in] pKnowledgeIn

Знание, допустимое для pbCurrentOwnerId и содержащее pVersionIn.

[in] pbCurrentOwnerId

Идентификатор реплика, которому принадлежит pVersionIn.

[in] pVersionIn

Преобразуемая версия.

[in] pbNewOwnerId

Возвращает идентификатор реплика, которому принадлежит преобразованная версия.

[in, out] pcbIdSize

Указывает количество байтов в pbNewOwnerId. Возвращает количество байтов, необходимых для получения идентификатора, если pbNewOwnerId слишком мал, или число записанных байтов.

[out] pVersionOut

Возвращает версию. Он преобразуется в допустимый для реплика, которому принадлежат эти знания.

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

Возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG
E_OUTOFMEMORY
HRESULT_FROM_WIN32(ERROR_MORE_DATA)	pbNewOwnerId слишком мал. В этом случае необходимое количество байтов возвращается в pcbIdSize.

Требования

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

См. также раздел

Интерфейс ISyncKnowledge

Структура SYNC_VERSION