IReplicaMetadata2::GetProviderVersion
Obtient la version du fournisseur qui opère sur ces métadonnées.
HRESULT GetProviderVersion(
ULONG * pulProviderVersion);
Paramètres
- pulProviderVersion
[out, retval] Retourne la version du fournisseur qui opère sur ces métadonnées.
Valeur de retour
S_OK
E_POINTER
Notes
La version de fournisseur est utilisée pour négocier la compatibilité avec d'autres versions d'un fournisseur. Examinez les cas suivants :
Il existe trois versions d'un fournisseur (v1, v2 et v3).
Dans la version v2, une modification incompatible a été apportée au schéma personnalisé du fournisseur.
v2 et v3 sont compatibles.
Un fournisseur v3 peut spécifier une valeur de v2 à IReplicaMetadata2::SetProviderVersion. Un fournisseur v2 ou v3 peut ensuite vérifier la version de fournisseur requise pour opérer sur les métadonnées à l'aide de GetProviderVersion. Étant donné que cette valeur est sérialisée dans le cadre du format canonique du magasin des métadonnées, la version de fournisseur peut également être vérifiée quand les métadonnées sont désérialisées, en spécifiant une valeur de v2 pour le paramètre dwExpectedProviderCompatibilityVersion d'ISyncMetadataStoreSerializer::DeserializeReplicaMetadata. Le fournisseur v1 attend une valeur de v1 et la désérialisation échouera par conception car les métadonnées sont incompatibles avec v1.
Utilisez la version la plus basse possible afin d'assurer le niveau de compatibilité le plus élevé avec d'autres versions du même fournisseur.