IReplicaMetadata2::GetProviderVersion
Obtiene la versión del proveedor que opera en estos metadatos.
HRESULT GetProviderVersion(
ULONG * pulProviderVersion);
Parámetros
- pulProviderVersion
[out, retval] Devuelve la versión del proveedor que opera en estos metadatos.
Valor devuelto
S_OK
E_POINTER
Notas
La versión del proveedor se utiliza para negociar la compatibilidad con otras versiones de un proveedor. Considere el escenario siguiente:
Existen tres versiones de un proveedor (v1, v2 y v3).
En v2, se efectuó un cambio incompatible en el esquema personalizado para el proveedor.
v2 y v3 son compatibles.
Un proveedor de v3 puede especificar un valor de v2 a IReplicaMetadata2::SetProviderVersion. A continuación, un proveedor de v2 o v3 puede comprobar la versión de proveedor requerida para operar en los metadatos utilizando GetProviderVersion. Dado que este valor se serializa como parte del formato canónico del almacén de metadatos, la versión del proveedor también se puede comprobar cuando se deserializan los metadatos, especificando un valor de v2 para el parámetro dwExpectedProviderCompatibilityVersion de ISyncMetadataStoreSerializer::DeserializeReplicaMetadata. El proveedor v1 espera un valor de v1 y se produciría un error de diseño en la deserialización ya que los metadatos son incompatibles con v1.
Utilice la versión más antigua posible para asegurar el nivel más alto de compatibilidad con otras versiones del mismo proveedor.