IProviderCustomFilteredSyncServices::DeserializeFilterKeyMap
Cria um objeto IFilterKeyMap e o inicializa usando dados serializados.
HRESULT DeserializeFilterKeyMap(
ISyncFilterDeserializer * pISyncFilterDeserializer,
const BYTE * pbFilterKeyMap,
DWORD dwCbFilterKeyMap,
IFilterKeyMap ** ppFilterKeyMap);
Parâmetros
- pISyncFilterDeserializer
[in] Um objeto que é usado para desserializar os filtros personalizados contidos nos dados serializados do mapa de chave de filtro.
- pbFilterKeyMap
[in, size_is(dwCbFilterKeyMap)] Os dados serializados do mapa de chave de filtro.
- dwCbFilterKeyMap
[in] O número de bytes em pbFilterKeyMap.
- ppFilterKeyMap
[out] Retorna o objeto do mapa de chave de filtro que é inicializado usando os dados serializados contidos em pbFilterKeyMap.
Valor de retorno
S_OK.
E_OUTOFMEMORY.
E_POINTER.
SYNC_E_DESERIALIZATION quando um problema ocorrer durante a serialização. Esse erro também é retornado quando a versão de serialização contida nos dados serializados for inferior a SYNC_SERIALIZATION_VERSION_V3.
SYNC_E_INVALID_OPERATION quando esse objeto não tiver sido inicializado com a chamada de IProviderSyncServices::Initialize.
Comentários
Um mapa de chave de filtro é usado por um provedor que representa uma réplica que controla filtros. O mapa de chave de filtro mapeia as chaves de filtro DWORD para objetos ISyncFilter.
Para desserializar os filtros personalizados contidos nos dados serializados, esse método chama ISyncFilterDeserializer::DeserializeSyncFilter uma vez para cada filtro nos dados serializados.