Interface IProviderConverter
En cas d'implémentation par une classe dérivée, représente un objet qui peut convertir un objet ISyncProvider en un objet IKnowledgeSyncProvider.
Syntaxe
interface IProviderConverter : IUnknown
Membres
Méthode IProviderConverter |
Description |
|---|---|
Initialise l'objet IProviderConverter avec l'objet ISyncProvider à convertir. |
Notes
IProviderConverter est généralement implémenté par le développeur du fournisseur personnalisé qu'il convertit.
Une implémentation de IProviderConverter doit être enregistrée avec Sync Framework à l'aide de IProviderConverterRegistration::RegisterProviderConverter. Cet enregistrement requiert l'IID de l'interface que le convertisseur peut convertir en IKnowledgeSyncProvider, et le CLSID que Sync Framework peut utiliser pour créer l'objet de convertisseur à l'aide de CoCreateInstance.
Lorsqu'un objet ISyncSession est utilisé pour gérer la synchronisation, Sync Framework requiert que chaque fournisseur soit représenté par IKnowledgeSyncProvider. Pour obtenir une interface IKnowledgeSyncProvider pour chaque fournisseur, Sync Framework réalise les opérations suivantes au cours du traitement de IApplicationSyncServices::CreateSyncSession :
Sync Framework interroge directement l'interface ISyncProvider qui représente le fournisseur en passant IID_IKnowledgeSyncProvider à la méthode QueryInterface de l'objet ISyncProvider.
Si QueryInterface retourne E_NOINTERFACE, Sync Framework examine les implémentations IProviderConverter enregistrées et détermine celles pouvant convertir l'objet ISyncProvider en un objet IKnowledgeSyncProvider.
Si un IProviderConverter enregistré peut convertir le fournisseur, Sync Framework obtient l'interface IKnowledgeSyncProvider de l'objet IProviderConverter. Sync Framework procède en passant tout d'abord l'objet ISyncProvider au convertisseur à l'aide de IProviderConverter::Initialize, puis en passant IID_IKnowledgeSyncProvider à la méthode QueryInterface de IProviderConverter.
Spécifications
En-tête : Synchronization.h