IReplicaMetadata2::GetProviderVersion
Ruft die Version des Anbieters ab, der mit diesen Metadaten arbeitet.
HRESULT GetProviderVersion(
ULONG * pulProviderVersion);
Parameter
- pulProviderVersion
[out, retval] Gibt die Version des Anbieters zurück, der mit diesen Metadaten arbeitet.
Rückgabewert
S_OK
E_POINTER
Hinweise
Die Anbieterversion wird verwendet, um die Kompatibilität mit anderen Versionen eines Anbieters auszuhandeln. Nehmen Sie das folgende Szenario als Beispiel:
Es gibt drei Versionen eines Anbieters (v1, v2 und v3).
In v2 wurde am benutzerdefinierten Schema für den Anbieter eine nicht kompatible Änderung vorgenommen.
v2 und v3 sind kompatibel.
Ein v3-Anbieter kann für IReplicaMetadata2::SetProviderVersion den Wert v2 angeben. Ein v2- oder v3-Anbieter kann dann mit GetProviderVersion die Anbieterversion überprüfen, die zum Arbeiten mit den Metadaten erforderlich ist. Da dieser Wert als Teil des kanonischen Formats des Metadatenspeichers serialisiert wird, kann die Anbieterversion auch überprüft werden, wenn die Metadaten deserialisiert werden, indem der Wert v2 für den dwExpectedProviderCompatibilityVersion-Parameter von ISyncMetadataStoreSerializer::DeserializeReplicaMetadata angegeben wird. Der v1-Anbieter würde den Wert v1 erwarten, und die Deserialisierung würde programmbedingt fehlschlagen, da die Metadaten nicht mit v1 kompatibel sind.
Verwenden Sie eine möglichst niedrige Version, um den höchsten Grad an Kompatibilität mit anderen Versionen desselben Anbieters zu gewährleisten.