共用方式為

IReplicaMetadata2::SetProviderVersion

  • 發行項

設定在此中繼資料上運作之提供者的版本。

HRESULT SetProviderVersion(
  ULONG ulProviderVersion);

參數

  • ulProviderVersion
    [in] 在此中繼資料上運作之提供者的版本。

傳回值

  • S_OK

  • E_OUTOFMEMORY

備註

這個提供者版本會用來與其他提供者版本交涉相容性。請考慮下列狀況：

  • 提供者有三種版本 (v1、v2 和 v3)。

  • 在 v2 中，針對提供者的自訂結構描述進行了不相容的變更。

  • v2 與 v3 相容。

v3 提供者可以指定 v2 值給 SetProviderVersion。然後，v2 或 v3 提供者就可以使用 IReplicaMetadata2::GetProviderVersion 來驗證在中繼資料上運作所需的提供者版本。因為這個值會序列化成中繼資料存放區之標準格式的一部分，所以在還原序列化中繼資料時，也可以針對 ISyncMetadataStoreSerializer::DeserializeReplicaMetadata 的 dwExpectedProviderCompatibilityVersion 參數指定 v2 值，藉以驗證提供者版本。v1 提供者會預期 v1 值，而且還原序列化應該會依照設計而失敗，因為中繼資料與 v1 不相容。

若要確保能夠與相同提供者的其他版本達到最高相容性層級，請盡可能使用最低版本。

請參閱

參考

IReplicaMetadata2 介面