IChangeApplicationServices::GetChangeApplicationContext
Возвращает объект, представляющий текущее изменение для применения.
HRESULT GetChangeApplicationContext(
ISyncChange * pSourceChange,
ISyncChange * pDestinationVersion,
IChangeApplicationContext ** ppContext);
Параметры
- pSourceChange
[in, unique] Изменение, полученное от поставщика источника. Может иметь значение NULL, когда пакет изменений является частью синхронизации восстановления.
- pDestinationVersion
[in, unique] Версия pSourceChange в реплике назначения. Может иметь значение NULL, если реплика назначения не имеет версии для pSourceChange.
- ppContext
[out] Возвращает объект, который может использоваться для обработки изменения.
Возвращаемое значение
S_OK.
E_OUTOFMEMORY.
E_POINTER.
Значение SYNC_E_ACTIVE_CHANGE_APPLICATION_CONTEXT, если объект IChangeApplicationContext уже активен. Обработка активного объекта IChangeApplicationContext должна выполняться до тех пор, пока его метод IChangeApplicationContext::GetChangeApplicationAction не вернет значение CAA_FINISHED. После этого можно переходить к обработке другого изменения.
Значение SYNC_E_CHANGE_NEEDS_KNOWLEDGE, если параметр pSourceChange не содержит определяющего набора знаний.
Значение SYNC_E_CHANGE_NOT_IN_KNOWLEDGE, если версия обновления или версия создания pSourceChange не содержится в его определяющем наборе знаний.
Значение SYNC_E_CHANGE_UNIT_COUNT_MISMATCH, если pSourceChange и pDestinationVersion содержат разное количество базовых единиц.
Значение SYNC_E_ID_FORMAT_MISMATCH, если формат указанного идентификатора не соответствует схеме формата идентификаторов, заданной при инициализации объекта.
Значение SYNC_E_INVALID_OPERATION, если применение изменений не запущено для пакета изменений или уже сообщено об успешном применении pSourceChange.
Значение SYNC_E_ITEM_HAS_CHANGE_UNITS, если один из параметров, pSourceChange или pDestinationVersion, содержит базовые единицы, а другой — нет.
Значение SYNC_E_NOT_EXPECTED_CHANGE, если pSourceChange и pDestinationVersion ссылаются на разные идентификаторы элементов.
Замечания
Этот метод обычно вызывается поставщиком назначения один раз для каждого изменения, отправляемого из поставщика источника. Возвращаемый объект IChangeApplicationContext можно использовать для выполнения обнаружения конфликтов, устранения конфликтов и определения порядка применения изменения, указанного параметром pSourceChange, поставщиком назначения.