ISynchronousDataRetriever

宛先プロバイダーがソースプロバイダーからアイテムデータを取得するための仕組みを表します。

プロバイダーの ID フォーマットスキーマを取得します。(ISynchronousDataRetriever.GetIdParameters)

返される可能性のあるコードには、次の表に示す値が含まれます (ただしこれらに限定されません)。

変更に対応するアイテムデータを取得します。(ISynchronousDataRetriever.LoadChangeData)

返される可能性のあるコードには、次の表に示す値が含まれます (ただしこれらに限定されません)。

ppUnkData で返されるオブジェクトが実装するデータ取得インターフェースは、ソースプロバイダーが決定します。宛先プロバイダーは、ppUnkData の QueryInterface メソッドを使用してこのインターフェースを取得できます。

例

次の例は、カスタムデータストア内から指定された変更を検索し、その複製を返す LoadChangeData の実装です。

STDMETHODIMP CItemStore::LoadChangeData(
    ILoadChangeContext * pLoadChangeContext,
    IUnknown ** ppUnkData)
{
    HRESULT hr = E_UNEXPECTED;

    if (NULL == pLoadChangeContext || NULL == ppUnkData)
    {
        hr = E_POINTER;    
    }
    else
    {
        // データストア内でアイテムを検索し、複製して、その IUnknown インターフェースを返します。
        ISyncChange* pChange = NULL;
        hr = pLoadChangeContext->GetSyncChange(&pChange);
        if (SUCCEEDED(hr))
        {
            SYNC_GID gidItem;
            DWORD cbID = sizeof(gidItem);
            hr = pChange->GetRootItemId((BYTE*)&gidItem, &cbID);
            if (SUCCEEDED(hr))
            {
                IXMLDOMNode* pNodeItem = NULL;
                hr = FindItem(&gidItem, &pNodeItem);
                if (SUCCEEDED(hr))
                {
                    IXMLDOMNode* pNodeClone = NULL;
                    hr = pNodeItem->cloneNode(TRUE, &pNodeClone);
                    if (SUCCEEDED(hr))
                    {
                        hr = pNodeClone->QueryInterface(IID_IUnknown, (void**)ppUnkData);

                        pNodeClone->Release();
                    }

                    pNodeItem->Release();                
                }
            }

            pChange->Release();
        }
    }

    return hr;
}