Compartilhar via


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

IProviderConverter::Initialize

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:

  1. O Sync Framework consulta diretamente a interface ISyncProvider que representa o provedor passando IID_IKnowledgeSyncProvider para o método QueryInterface do objeto ISyncProvider.

  2. 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.

  3. 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

Consulte também

Conceitos

Componentes principais do Sync Framework