ISyncDataConverter::ConvertDataRetrieverFromProviderFormat
データ取得元を、関連付けられたプロバイダーの形式から必要なデータ取得元の形式に変換します。このメソッドが必要になるのは、同期セッション内のプロバイダーのいずれかまたは両方が ISynchronousDataRetriever または IAsynchronousDataRetriever 以外のインターフェイスを使用してデータを取得する場合のみです。
構文
HRESULT ConvertDataRetrieverFromProviderFormat(
IUnknown * pUnkDataRetrieverIn,
IEnumSyncChanges * pEnumSyncChanges,
IUnknown ** ppUnkDataOut);
パラメーター
pUnkDataRetrieverIn
[in] 変換するデータ取得元です。pEnumSyncChanges
[in] 一連の項目変更を表す IEnumSyncChanges オブジェクトです。ppUnkDataOut
[out] 変換されたデータ取得元です。
戻り値
S_OK
E_NOTIMPL (データ取得元が組み込みのインターフェイスの 1 つを実装し、データ変換のみが必要な場合)
開発者が定義したエラー値
E_NOTIMPL 以外のエラーが返されると、同期セッションが終了し、エラー コードが返されます。
説明
通常、最も効率的にデータ取得元を変換するには、必要なデータ取得元インターフェイスを実装してプロバイダーのデータ取得元インターフェイスへのポインターを保持するプロキシを作成します。その後、同期セッション中に変更が処理されると、プロキシはプロバイダー インターフェイスからデータを取得できます。リモートの変更を伴うアプリケーション シナリオなど、場合によっては、最初にすべての変更を取得し、必要に応じて変換してから、データ取得元とその中のデータすべてをシリアル化する必要があります。このような場合は、pEnumSyncChanges を使用して、シリアル化が必要な変更をすべて列挙します。