IChangeApplicationServices::BeginChangeApplication
Inicia o processamento de um conjunto de alterações.
HRESULT BeginChangeApplication(
ISyncKnowledge * pDestinationKnowledge,
IForgottenKnowledge * pDestinationForgottenKnowledge,
ISyncFilterInfo * pFilterInfo,
ISyncCallback * pSyncCallback,
IUnknown * pSourceDataRetriever,
IUnknown * pDestinationDataRetriever);
Parâmetros
- pDestinationKnowledge
[in] O conhecimento atual da réplica de destino.
- pDestinationForgottenKnowledge
[in, unique] O conhecimento esquecido atual da réplica de destino. Pode ser NULL.
- pFilterInfo
[in, unique] Informações sobre filtros usados pelo provedor de destino. Pode ser NULL.
- pSyncCallback
[in, unique] Retornos de chamada que receberão notificações sobre eventos de aplicação de alterações. Pode ser NULL.
- pSourceDataRetriever
[in] Um objeto que pode ser usado para recuperar dados de item a partir da réplica de origem.
- pDestinationDataRetriever
[in] Um objeto que pode ser usado para recuperar dados de item a partir da réplica de destino.
Valor de retorno
S_OK.
E_OUTOFMEMORY.
E_POINTER.
SYNC_E_ID_FORMAT_MISMATCH quando o esquema do formato da ID dos objetos de conhecimento especificados não corresponde ao esquema do formato da ID especificado quando esse objeto foi inicializado.
SYNC_E_INVALID_OPERATION quando este objeto não tiver sido inicializado ou quando a aplicação de alterações tiver sido iniciada, mas não concluída, no conjunto de alterações.
Comentários
Geralmente, esse método é chamado uma vez para cada lote de alterações que é recebido pelo método IKnowledgeSyncProvider::ProcessChangeBatch do provedor de destino.
Esse método deve ser chamado antes que o conhecimento possa ser definido ou calculado, ou as alterações aplicadas ou relatadas.