ISyncDataConverter::ConvertDataFromProviderFormat

Converts data from a provider’s transfer format to the required output format. The output format can be another provider's transfer format or an intermediate format that is used by a synchronization community.

HRESULT ConvertDataFromProviderFormat(
  ILoadChangeContext *pDataContext,
  IUnknown *pUnkDataIn,
  IUnknown **ppUnkDataOut);

Parameters

  • pDataContext
    [in] An ILoadChangeContext object that represents information about a change to be loaded from the item store. This object can be used to set a recoverable error for a change if an issue occurs during data conversion.
  • pUnkDataIn
    [in] The data to be converted.
  • ppUnkDataOut
    [out] The converted data.

Return Value

  • S_OK

  • Developer-defined error values

Remarks

If an error is returned from this method during data conversion, the synchronization session ends and returns the error code. If a recoverable error occurs during data conversion, sets that error on pDataContext instead of returning it. The item for which the error is set is then skipped during change application.

See Also

Reference

ISyncDataConverter Interface

Concepts

Converting Data Between Providers