Interface IProviderConverter
Quando implementada por uma classe derivada, representa um objeto que pode converter um objeto ISyncProvider em um objeto IKnowledgeSyncProvider.
interface IProviderConverter : IUnknown
Membros
| Método IProviderConverter | Descrição |
|---|---|
Inicializa o objeto IProviderConverter com o objeto ISyncProvider a ser convertido. |
Comentários
IProviderConverter geralmente é implementado pelo desenvolvedor do provedor personalizado que ele converte.
Uma implementação de IProviderConverter deve ser registrada no Sync Framework usando IProviderConverterRegistration::RegisterProviderConverter. Esse registro requer a IID da interface que o conversor pode converter em IKnowledgeSyncProvider e o CLSID que o Sync Framework pode usar para criar o objeto conversor usando CoCreateInstance.
Quando um objeto ISyncSession é usado para gerenciar a sincronização, o Sync Framework requer que cada provedor seja representado por IKnowledgeSyncProvider. Para obter uma interface IKnowledgeSyncProvider para cada provedor, o Sync Framework executa as seguintes etapas durante o processamento de IApplicationSyncServices::CreateSyncSession:
O Sync Framework consulta diretamente a interface ISyncProvider que representa o provedor passando IID_IKnowledgeSyncProvider para o método QueryInterface do objeto ISyncProvider.
Se QueryInterface retornar E_NOINTERFACE, o Sync Framework examinará as implementações de IProviderConverter registradas e determinará qual delas pode converter o objeto ISyncProvider a um objeto IKnowledgeSyncProvider.
Se for registrado um IProviderConverter que possa converter o provedor, o Sync Framework obterá a interface IKnowledgeSyncProvider do objeto IProviderConverter. Para isso, o Sync Framework primeiro passa o objeto ISyncProvider para o conversor usando IProviderConverter::Initialize e, em seguida, passa IID_IKnowledgeSyncProvider para o método QueryInterface do IProviderConverter.
Requisitos
Cabeçalho: Synchronization.h